renvoie une expression mise en forme sous forme de pourcentage (multipliée par 100) avec un caractère % à droite.
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 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.
Remarque
Toutes les informations sur les paramètres proviennent de l’onglet Numéro de paramètres régionaux .
Exemples
| Expression | Résultats |
|---|---|
| SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales ; | Convertit les valeurs du champ « DPercent » au format « Pourcentage » et renvoie les valeurs 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 virgule, les valeurs négatives seront couvertes entre parenthèses, la valeur sera regroupée par délimiteur par défaut (« 10 » s’affiche sous la forme 1 000,00 %, « -10 » apparaît sous la forme (1 000,00 %), « 0 » s’affiche sous la forme 0,00 %). |