Retourne 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 d’emplacements affichés à droite de la décimale. 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 Tristate qui indique si un zéro non significatif est affiché pour les valeurs fractionnaires. Consultez la section Paramètres pour connaître les valeurs. |
|
UseParensForNegativeNumbers |
Facultatif. Constante tristate qui indique s’il faut placer ou non des valeurs négatives entre parenthèses. Consultez la section Paramètres pour connaître les valeurs. |
|
GroupDigits |
Facultatif. Constante Tristate 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. Consultez la section Paramètres pour connaître 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 des paramètres régionaux .
Exemples
|
Expression |
Résultats |
|
SELECT FormatNumber([SalePrice]) AS Expr1 FROM ProductSales ; |
Met en forme les valeurs monétaires du champ « SalePrice » au format « Nombre » et retourne 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 décimale, les valeurs négatives seront couvertes entre parenthèses, la valeur sera regroupée par délimiteur par défaut (« 1 000 » sera affiché comme 1 000,00, « -1000 » sera affiché sous la forme (1 000,00), « 0 » sera affiché sous la forme 0,00). |
