Fonctions Decimal, Float et Value

S’applique à : Applications canevas Dataverse  Colonnes de formules  Flux Bureau  Applications pilotées par modèle Power Pages Power Platform  CLI

Convertit une chaîne de texte ou d’autres types en nombre.

Description

Utilisez les fonctions Decimal, Float et Value pour convertir une chaîne de texte contenant des caractères numériques en valeur numérique. Utilisez ces fonctions lorsque vous devez effectuer des calculs sur des nombres saisis sous forme de texte par un utilisateur. Ces fonctions peuvent également être utilisées pour convertir d’autres types en nombre, comme une date/heure et un booléen.

La fonction Value renverra le type de données numérique par défaut pour l’hôte Power Fx que vous utilisez, qui est généralement Decimal et le meilleur choix pour la plupart des situations. Utilisez les fonctions Decimal et Float lorsque vous avez besoin d’un type de données spécifique pour un scénario particulier, comme un calcul scientifique avec un très grand nombre. Pour plus de détails sur l’utilisation de ces types de données, consultez la section Nombres de Types de données.

Selon les langues, les symboles , et . peuvent être interprétés différemment. Par défaut, le texte est interprété dans la langue de l’utilisateur actuel. Vous pouvez spécifier la langue à utiliser à l’aide d’une balise de langue, en utilisant les mêmes balises de langue que celles renvoyées par la fonction Language.

Remarques sur le format de la chaîne :

• La chaîne peut être précédée d’un symbole monétaire de la langue actuelle. Le symbole monétaire est ignoré. Les symboles monétaires d’autres langues ne sont pas ignorés.
• La chaîne peut inclure un signe de pourcentage (%) à la fin, indiquant qu’il s’agit d’un pourcentage. Le nombre sera divisé par 100 avant d’être renvoyé. Les pourcentages et les symboles monétaires ne peuvent pas être combinés.
• La chaîne peut être présentée en notation scientifique, avec 12 x 10³ exprimé sous la forme « 12e3 ».

Si le nombre n’est pas au format approprié, ces fonctions renverront une erreur.

Pour convertir des valeurs de date et d’heure, utilisez les fonctions DateValue, TimeValue ou DateTimeValue.

Syntaxe

Décimal( String [, LanguageTag ] )
Flotteur( String [, LanguageTag ] )
Valeur( Chaîne [, LanguageTag ] )

• Chaîne - Obligatoire. Chaîne à convertir en valeur numérique.
• LanguageTag - Facultatif. Balise de langue dans laquelle analyser la chaîne. Par défaut, la langue de l’utilisateur actuel est utilisée.

Décimal( Non typé )
Float( Non typé )
Valeur( Non typé )

• Non typé - Obligatoire. objet sans type qui représente un nombre. Les valeurs acceptables dépendent du fournisseur sans type. Pour JSON, l’objet sans type doit être un nombre JSON, une valeur booléenne ou un texte pouvant être converti en nombre. Gardez à l’esprit que les fuseaux horaires et les formats liés aux paramètres régionaux sont des considérations importantes lors de la communication avec des systèmes externes.

Examples

L’utilisateur qui exécute ces formules se trouve aux États-Unis et a sélectionné l’anglais comme langue. La fonction Language renvoie la valeur « en-US ». L’hôte Power Fx utilise Decimal par défaut.

Value et Decimal

Puisque nous utilisons un hôte qui a Decimal comme valeur par défaut, Value et Decimal renverront les mêmes résultats.

Float

La fonction Float aura des résultats très proches des résultats ci-dessus. Étant donné que 123.456 ne peut pas être représenté avec précision dans Float, le résultat est une approximation très proche (123.456000000000003069544618484E2) et les calculs d’erreurs d’arrondi de composition pourraient générer un résultat inattendu. Le type résultant sera Float à la place.

Là où les choses divergent, c’est si des nombres plus grands ou plus petits sont utilisés.