Retourne une expression mise en forme en tant que valeur monétaire à l’aide du symbole monétaire défini dans le panneau de configuration du 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 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.
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 de 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 ; | Met en forme les valeurs numériques du champ « UnitPrice » au format « Currency » et retourne dans la colonne Expr1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales ; | Met en forme les valeurs numériques du champ « Discount » au format « Devise » 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 » s’affichera comme 0,00 $). |