Renvoie une expression mise en forme en tant que valeur monétaire à l’aide du symbole monétaire défini dans le Panneau de configuration système.
Syntaxe
FormatCurrency(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La syntaxe de la fonction FormatCurrency 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.
La position du symbole monétaire par rapport à la valeur monétaire est déterminée par les paramètres régionaux du système.
Remarque
Toutes les informations sur les paramètres proviennent de l’onglet Paramètres régionaux - Devise , à l’exception du zéro non significatif qui provient de l’onglet Nombre .
Exemples
| Expression | Résultats |
|---|---|
| SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales ; | Convertit les valeurs numériques du champ « PrixUnitaire » au format « Devise » et les renvoie dans la colonne Expr1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Met en forme les valeurs numériques du champ « Remise » au format « Devise » avec 2 décimales, toutes les valeurs inférieures à 1 auront « 0 » avant la décimale, les valeurs négatives seront entre parenthèses, la valeur sera regroupée par délimiteur par défaut (« 1000 » s’affiche sous la forme 1 000,00 $, « -1000 » est affiché sous la forme (1 000,00 $), « 0 » apparaît sous la forme 0,00 $). |