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 $). |