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. |
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 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 %. |