FORMATNUMBER |
Nombre formaté |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function FormatNumber(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é selon un format de nombre.
Remarques
- La fonction FormatNumber permet de présenter un nombre de manière lisible et standardisée, selon des règles précises de mise en forme. Elle est utile pour rendre des résultats numériques compréhensibles pour les utilisateurs finaux, surtout dans des rapports ou des interfaces financières. Son usage évite d'avoir à gérer manuellement la mise en forme à l'aide de chaînes ou de fonctions arithmétiques.
- Le paramètre NumDigAfterDec contrôle le nombre de chiffres après la virgule (ou le point décimal selon les paramètres régionaux). Cela permet d'adapter le niveau de précision affiché en fonction du contexte, par exemple deux décimales pour les montants financiers. Ce paramètre renforce la cohérence dans l'affichage de données chiffrées dans une même application.
- Le paramètre IncLeadingDig détermine si un zéro doit précéder les valeurs fractionnaires inférieures à 1, comme "0.75" ou ".75". Ce choix influence la lisibilité des nombres : l'inclusion du zéro est généralement préférée pour éviter toute ambiguïté. Les options -2, -1 et 0 permettent de respecter soit le comportement par défaut, soit d'imposer ou d'interdire cette inclusion.
- Le paramètre UseParForNegNum indique si les nombres négatifs doivent être affichés entre parenthèses, ce qui est courant en comptabilité. Par exemple, "-500" peut être affiché comme "(500)", ce qui permet d'éviter l'usage du signe moins tout en gardant le sens négatif. Cette fonctionnalité apporte une flexibilité de présentation adaptée à différents standards visuels ou métiers.
- Le paramètre GroupDig permet de regrouper les chiffres par milliers en utilisant les séparateurs régionaux (par exemple "1,000" ou "1 000"). Cela rend les grands nombres bien plus faciles à lire et à interpréter, notamment dans des colonnes de rapports chiffrés. Désactiver ce regroupement peut toutefois être pertinent dans des traitements purement techniques ou mathématiques.
- En l'absence de certains paramètres, la fonction applique les valeurs par défaut du système, ce qui peut simplifier son utilisation dans des cas courants. Cependant, il est conseillé de préciser ces paramètres lorsque l'on souhaite un rendu précis ou conforme à des normes particulières. Cela améliore la fiabilité et la cohérence des affichages, surtout dans les applications multilingues.
- La sortie de FormatNumber dépend également des paramètres régionaux du serveur, comme le choix du séparateur décimal (virgule ou point). Dans un environnement international, il peut être nécessaire d'uniformiser ces réglages pour assurer un affichage cohérent entre utilisateurs. Cela souligne l'importance de maîtriser à la fois la fonction elle-même et son contexte d'exécution.
- FormatNumber est très pratique pour les affichages dynamiques de résultats de calculs, notamment dans des interfaces utilisateur HTML générées par ASP. Elle permet d'afficher des totaux, des moyennes ou des pourcentages de manière élégante, avec des options de formatage souples. Son intégration dans une logique ASP simplifie grandement la gestion de la présentation des données numériques côté serveur.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "10000 = " & FormatNumber(10000) & "<br />"
- Response.Write "10000.587,2 = " & FormatNumber(10000.587,2) & "<br />"
- Response.Write "10000.587,2,,,0 = " & FormatNumber(10000.587,2,,,0) & "<br />"
- Response.Write "13567 = " & FormatNumber(13567) & "<br />"
- Response.Write "13567.8977 = " & FormatNumber(13567.8977) & "<br />"
- Response.Write "30000 = " & FormatNumber(30000) & "<br />"
- Response.Write "30000.587,2 = " & FormatNumber(30000.587,2) & "<br />"
- Response.Write "30000.587,2,,,0 = " & FormatNumber(30000.587,2,,,0) & "<br />"
- Response.Write "31567 = " & FormatNumber(31567) & "<br />"
- Response.Write "31567.9877 = " & FormatNumber(31567.9877) & "<br />"
- %>
on obtiendra le résultat suivant :
10000 = 10 000,0010000.587,2 = 10 000,59
10000.587,2,,,0 = 10000,59
13567 = 13 567,00
13567.8977 = 13 567,90
30000 = 30 000,00
30000.587,2 = 30 000,59
30000.587,2,,,0 = 30000,59
31567 = 31 567,00
31567.9877 = 31 567,99
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014