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

Masque qui indique comment le premier paramètre doit être formaté. Ces symboles sont utilisés pour définir le masque.
  • 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
  • $ = $
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.
  • $#,##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'
Exemple 2

#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)'