FORMATPERCENT |
Format de pourcentage |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function FormatPercent(expression[,NumDigAfterDec[,IncLeadingDig[,UseParForNegNum[,GroupDig]]]]) |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| expression | Ce paramètre permet d'indiquer l'expression à convertir | ||
| NumDigAfterDec | Ce paramètre permet d'indiquer le nombre de décimal | ||
| IncLeadingDig | Ce paramètre permet d'indiquer si le nombre de zéro soit affiché par valeurs fractionnaire : | ||
| Valeur | Description | ||
| -2 | Cette valeur permet d'indiquer qu'il faut utiliser la valeur par défaut. | ||
| -1 | Cette valeur permet d'indiquer qu'il faut que le nombre de zéro soit affiché par valeurs fractionnaire. | ||
| 0 | Cette valeur permet d'indiquer qu'il ne faut pas que le nombre de zéro soit affiché par valeurs fractionnaire. | ||
| UseParForNegNum | Ce paramètre permet d'indiquer s'il faut placer les valeurs négatifs entre parenthèse : | ||
| Valeur | Description | ||
| -2 | Cette valeur permet d'indiquer qu'il faut utiliser la valeur par défaut. | ||
| -1 | Cette valeur permet d'indiquer qu'il faut placer les valeurs négatifs entre parenthèse. | ||
| 0 | Cette valeur permet d'indiquer qu'il ne faut pas placer les valeurs négatifs entre parenthèse. | ||
| GroupDig | Ce paramètre permet d'indiquer s'il faut regrouper les nombres en utilisant les délimiteurs régionales : | ||
| Valeur | Description | ||
| -2 | Cette valeur permet d'indiquer qu'il faut utiliser la valeur par défaut. | ||
| -1 | Cette valeur permet d'indiquer qu'il faut regrouper les nombres en utilisant les délimiteurs régionales. | ||
| 0 | Cette valeur permet d'indiquer qu'il ne faut pas regrouper les nombres en utilisant les délimiteurs régionales. | ||
Description
Cette fonction retourne une expression formaté avec un pourcentage.
Remarques
- La fonction FormatPercent permet de convertir une expression numérique en pourcentage, en multipliant automatiquement la valeur par 100. Par exemple, la valeur 0.25 devient "25%", ce qui est beaucoup plus lisible dans une interface utilisateur ou un rapport. Cela évite d'avoir à gérer manuellement la multiplication et l'ajout du symbole %.
- Le paramètre NumDigAfterDec est très utile pour maîtriser la précision affichée dans le pourcentage. On peut, par exemple, afficher "25.00%" au lieu de "25%" pour un affichage plus détaillé. C'est particulièrement pertinent pour des calculs précis, comme des taux de croissance ou des variations statistiques.
- Comme pour d'autres fonctions de formatage, FormatPercent accepte le paramètre IncLeadingDig qui contrôle l'affichage du zéro avant les valeurs fractionnaires. Bien que cet aspect soit rarement visible dans un pourcentage entier, il peut influencer le rendu si l'on affiche des valeurs très petites, comme "0.05%". Cela améliore la cohérence visuelle dans des tableaux contenant des pourcentages à différentes échelles.
- Le paramètre UseParForNegNum permet d'enrober les pourcentages négatifs entre parenthèses, comme "(12%)" au lieu de "-12%". Ce format est très courant dans les domaines financiers, où l'on souhaite éviter les signes négatifs explicites tout en maintenant la signification. C'est un moyen élégant de signaler une baisse ou une perte, sans alourdir la lecture.
- Le paramètre GroupDig permet de regrouper les chiffres par milliers si le pourcentage dépasse 999, bien que ce soit rare. Cela peut cependant arriver dans certains contextes statistiques ou lorsque l'unité de base est très petite. Dans ce cas, le regroupement aide à lire facilement des valeurs comme "1,200.00%" ou "15,000%".
- Comme pour les autres fonctions de formatage numériques en ASP, les valeurs -2, -1 et 0 dans les paramètres permettent de contrôler finement le comportement par défaut ou personnalisé. Cela offre une grande souplesse pour ajuster la présentation selon les préférences de l'utilisateur ou les normes du projet. C'est un point fort pour la personnalisation de l'affichage côté serveur.
- La fonction FormatPercent est particulièrement utile dans les applications de reporting ou de tableaux de bord où les taux sont omniprésents. Elle permet d'automatiser le rendu des taux d'intérêt, de rendement ou de progression sans erreurs d'arrondi ou d'unité. Cela renforce la lisibilité globale tout en réduisant les traitements manuels.
- Attention toutefois à bien adapter les valeurs d'entrée à la logique de la fonction : une valeur de 0.5 affichera "50%", ce qui peut surprendre si l'on s'attendait à un affichage direct. Cela implique que les valeurs doivent être exprimées en proportions (entre 0 et 1) et non déjà en pourcentage. Ce comportement doit être bien compris pour éviter des erreurs d'affichage ou de confusion dans les résultats.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "10000 = " & FormatPercent(10000) & "<br />"
- Response.Write "10000.587,2 = " & FormatPercent(10000.587,2) & "<br />"
- Response.Write "10000.587,2,,,0 = " & FormatPercent(10000.587,2,,,0) & "<br />"
- Response.Write "13567 = " & FormatPercent(13567) & "<br />"
- Response.Write "13567.8977 = " & FormatPercent(13567.8977) & "<br />"
- Response.Write "30000 = " & FormatPercent(30000) & "<br />"
- Response.Write "30000.587,2 = " & FormatPercent(30000.587,2) & "<br />"
- Response.Write "30000.587,2,,,0 = " & FormatPercent(30000.587,2,,,0) & "<br />"
- Response.Write "31567 = " & FormatPercent(31567) & "<br />"
- Response.Write "31567.9877 = " & FormatPercent(31567.9877) & "<br />"
- %>
on obtiendra le résultat suivant :
10000 = 1 000 000,00%10000.587,2 = 1 000 058,70%
10000.587,2,,,0 = 1000058,70%
13567 = 1 356 700,00%
13567.8977 = 1 356 789,77%
30000 = 3 000 000,00%
30000.587,2 = 3 000 058,70%
30000.587,2,,,0 = 3000058,70%
31567 = 3 156 700,00%
31567.9877 = 3 156 798,77%
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014