Fonction de formatage de nombre
La fonction Formatage de nombre renvoie une chaîne constituée d'un nombre formaté pour s'adapter au masque spécifié.
Paramètre : nombre
Nombre à formater. Celui-ci peut provenir d'un noeud source, du résultat d'une autre fonction ou d'une valeur que vous indiquez.
Paramètre : chaîne
- Chiffres obligatoires = 0
- Chiffres facultatifs = #
- Symbole moins = -
- Symbole décimal = .
- Séparateur de groupes = ,. Généralement utilisé pour séparer des groupes de trois chiffre.
- Symbole de pourcentage = %. Lorsque le symbole de pourcentage est présent, le nombre d'entrée est multiplié par 100 et le résultat s'affiche sous la forme d'un pourcentage.
- Symbole par mille = (Unicode x2030). Ce symbole multiplie le nombre par 1000 et montre le résultat comme étant par mille.
- Séparateur positif/négatif = ;
- Infinité = infinité
- Not-a-number = NaN
- $ = $
- $#,##0.00 – Formate un nombre au format standard pour les dollars des États-Unis avec le symbole du dollar, des virgules comme séparateurs et au moins un chiffre pour les dollars et deux chiffres pour les cents.
- #0.000% – Formate un nombre décimal sous la forme d'un pourcentage avec au moins trois positions décimales.
- #,##0.00;(#,##0.00) – Formate un nombre négatif avec des parenthèses, un format couramment utilisé pour la comptabilité.
Renvoie : chaîne
Premier paramètre reformaté pour refléter le masque spécifié par le deuxième paramètre.
Exemples
Les masques peuvent avoir un texte constant comme préfixe, suffixe, ou les deux. Il s'agit souvent du symbole monétaire ou d'une unité de mesure.
Exemple 1$#,##0.00 – Formate un nombre au format standard pour les dollars des États-Unis avec le symbole du dollar, des virgules comme séparateurs et au moins un chiffre pour les dollars et deux chiffres pour les cents.
format-number(12345.6789,'$#,##0.00') = '$12,345.67'#0.000% – Formate un nombre décimal sous la forme d'un pourcentage avec au moins trois positions décimales.
format-number(.67890123,'#0.000%') = '67.890%'Lorsque le symbole de pourcentage est présent, le nombre d'entrée est multiplié par 100.
Exemple 3#,##0.00;(#,##0.00) – Formate un nombre négatif avec des parenthèses, un format couramment utilisé pour la comptabilité.
format-number(-12345.6789,'#,##0.00;(#,##0.00)') = '(12,345.67)'