Fonction FormatPercent

S’applique à
Access pour Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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