Retourne une expression au format pourcentage (multipledée de 100) avec un caractère % de fin.
Syntaxe
FormatPercent ( Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La syntaxe de la fonction FormatPercent 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. |
Notes
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 FormatPercent([DPercent]) AS Expr1 FROM ProductSales ; |
Met en forme les valeurs du champ « DPercent » au format « Percent » et retourne dans la colonne Expr1. |
|
SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales ; |
Met en forme les valeurs du champ « DPercent » au format « Pourcentage » 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 (« 10 » sera affiché comme 1 000,00 %, « -10 » sera affiché comme (1 000,00 %), « 0 » sera affiché sous la forme 0,00 %. |
