Renvoie une expression mise en forme sous forme de nombre.
Syntaxe
FormatNumber(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La syntaxe de la fonction FormatNumber contient les arguments suivants :
| Argument | Description |
|---|---|
| Expression | Obligatoire. Expression à mettre en forme. |
| NumDigitsAfterDecimal | Facultatif. Valeur numérique indiquant le nombre de positions à droite du séparateur décimal qui sont 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 à trois états qui indique si un zéro non significatif est affiché ou non pour les valeurs fractionnaires. Voir la section Paramètres pour les valeurs. |
| UseParensForNegativeNumbers | Facultatif. Constante à trois états qui indique s’il faut placer ou non des valeurs négatives entre parenthèses. Voir la section Paramètres pour les valeurs. |
| GroupDigits | Facultatif. Constante à trois états qui indique si les nombres sont regroupés ou non à l’aide du délimiteur de groupe spécifié dans les paramètres régionaux de l’ordinateur. Voir la section Paramètres pour les valeurs. |
Paramètres
Les arguments IncludeLeadingDigit, UseParensForNegativeNumbers et GroupDigits ont les paramètres suivants :
| Constante | Valeur | Description |
|---|---|---|
| vbTrue | –1 | Vraie |
| vbFalse | 0 | Fausse |
| vbUseDefault | –2 | Utilisez le paramètre des paramètres régionaux de l’ordinateur. |
Remarques
Lorsqu’un ou plusieurs arguments facultatifs sont omis, les valeurs des arguments omis sont fournies par les paramètres régionaux de l’ordinateur.
Remarque
Toutes les informations sur les paramètres proviennent de l’onglet Numéro de paramètres régionaux .
Exemples
| Expression | Résultats |
|---|---|
| SELECT FormatNumber([SalePrice]) AS Expr1 FROM ProductSales ; | Convertit les valeurs monétaires du champ « PrixSale » au format « Nombre » et les renvoie dans la colonne Expr1. |
| SELECT FormatNumber([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales ; | Met en forme les valeurs numériques du champ « Remise » au format « Nombre » avec 2 décimales, toutes les valeurs inférieures à 1 auront « 0 » avant la virgule, les valeurs négatives seront couvertes entre parenthèses, la valeur sera regroupée par délimiteur par défaut (« 1000 » sera affiché sous la forme 1 000,00, « -1000 » sera affiché comme (1 000,00), « 0 » sera affiché comme 0,00). |