Fonction FormatNumber

Renvoie une expression formatée en tant que nombre.

Syntaxe

FormatNumber(Expression [,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]])

Arguments :

  • Expression : requis. Expression à formater.
  • NumDigitsAfterDecimal : facultatif. Valeur numérique indiquant le nombre de décimales affichées. La valeur par défaut est -1, ce qui indique que les paramètres régionaux de l'ordinateur sont utilisés.
  • IncludeLeadingDigit : facultatif. Constante indiquant si un zéro est affiché à gauche pour les valeurs fractionnaires. Pour connaître les valeurs, reportez-vous à la section Paramètres.
  • UseParensForNegativeNumbers : facultatif. Constante indiquant si les valeurs négatives doivent être placées entre parenthèses. Pour connaître les valeurs, reportez-vous à la section Paramètres.
  • GroupDigits : facultatif. Constante indiquant si les chiffres sont regroupés à l'aide du séparateur de groupe spécifié dans le panneau de configuration. Pour connaître les valeurs, reportez-vous à la section Paramètres.

Paramètres : les arguments IncludeLeadingDigit, UseParensForNegativeNumbers et GroupDigits ont les paramètres ci-après.

Tableau 11-12 Paramètres : fonction FormatNumber

Valeur Description
-1 True
0 False
-2 Les paramètres régionaux de l'ordinateur sont utilisés.

Remarques :

Lorsque des arguments facultatifs sont omis, les valeurs de ces arguments sont fournies par les paramètres régionaux de l'ordinateur.

Remarque :

Toutes les informations sur les paramètres proviennent de l'onglet relatif aux nombres dans les paramètres régionaux.

Les exemples suivants illustrent l'utilisation de la fonction FormatNumber avec les différentes sorties attendues :

Dim formattedNum
formattedNum = FormatNumber(20000)
'formattedNum Outputs: 20,000.00
formattedNum = FormatNumber(20000,2)
'formattedNum Outputs: 20,000.00
formattedNum = FormatNumber(20000,5)
'formattedNum Outputs: 20,000.00000
formattedNum = FormatNumber(.20) 
'formattedNum Outputs: 0.20
formattedNum = FormatNumber(.20,2,0)    
'formattedNum Outputs: .20
formattedNum = FormatNumber(.20,2,-1) 
'formattedNum Outputs: 0.20
formattedNum = FormatNumber(-50) 
'formattedNum Outputs: -50.00
formattedNum = FormatNumber(-50,1,-1,0) 
'formattedNum Outputs: -50.0
formattedNum = FormatNumber(-50,1,-1,-1) 
'formattedNum Outputs: (50.0)
formattedNum = FormatNumber(10000000) 
'formattedNum Outputs: 10,000,000.00
formattedNum = FormatNumber(10000000,1,-1,-1,0) 
'formattedNum Outputs: 10000000.0
formattedNum = FormatNumber(10000000,1,-1,-1,-1) 
'formattedNum Outputs: 10,000,000.0