FORMATCURRENCY |
Format de monnaie |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function FormatCurrency(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 monnaie.
Remarques
- La fonction FormatCurrency permet de formater automatiquement une valeur numérique en format monétaire, ce qui est très utile pour afficher des montants dans une application Web. Elle applique les paramètres de format régionaux par défaut, comme le symbole monétaire, la position des décimales et les séparateurs. C'est une solution simple pour garantir une présentation professionnelle des montants.
- Le paramètre NumDigAfterDec permet de contrôler le nombre de chiffres après la virgule. Par exemple, une valeur de 2 donnera 123,45 alors qu'une valeur de 0 donnera simplement 123. Ce paramètre est essentiel lorsqu'on souhaite arrondir ou tronquer visuellement les montants affichés.
- Le paramètre IncLeadingDig permet de définir si une valeur inférieure à 1 doit inclure un zéro avant la virgule, comme 0,75 ou simplement ,75. Cela peut sembler un détail, mais c'est important pour la clarté visuelle et le respect des conventions d'affichage locales. Un affichage cohérent améliore la compréhension des utilisateurs.
- Grâce au paramètre UseParForNegNum, la fonction peut afficher les nombres négatifs entre parenthèses au lieu d'utiliser le signe moins. Par exemple, -125 peut s'afficher comme (125,00) selon les préférences. Ce style est courant en comptabilité, car il rend les valeurs négatives plus lisibles dans les tableaux financiers.
- Le paramètre GroupDig contrôle l'utilisation des séparateurs de milliers, tels que les espaces ou les virgules selon la région (ex. 1 000,00 ou 1,000.00). Son activation rend les montants plus faciles à lire, surtout lorsqu'ils dépassent les milliers. Désactiver ce regroupement est rare, mais peut être utile dans des exportations ou traitements automatiques.
- Chaque paramètre optionnel peut prendre la valeur -2 pour laisser le système utiliser les paramètres par défaut du serveur ou de l'utilisateur. Cela évite d'avoir à spécifier manuellement tous les paramètres si le comportement standard est satisfaisant. C'est pratique pour garder la fonction simple à utiliser sans sacrifier la flexibilité.
- Le résultat retourné par FormatCurrency est de type chaîne de caractères, donc même si l'entrée est un nombre, la sortie est une valeur textuelle. Cela signifie qu'on ne peut pas utiliser directement le résultat dans des calculs mathématiques sans le reconvertir. Il convient donc de l'utiliser uniquement au moment de l'affichage.
- La fonction FormatCurrency est parfaitement adaptée aux sites multilingues ou internationaux, car elle respecte les conventions régionales (paramètres NLS). Elle garantit une présentation localisée sans effort, en fonction du paramétrage du serveur ou de l'environnement utilisateur. Cela permet une meilleure expérience utilisateur dans des contextes commerciaux mondiaux.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "10000 = " & FormatCurrency(10000) & "<br />"
- Response.Write "10000.587,2 = " & FormatCurrency(10000.587,2) & "<br />"
- Response.Write "10000.587,2,,,0 = " & FormatCurrency(10000.587,2,,,0) & "<br />"
- Response.Write "13567 = " & FormatCurrency(13567) & "<br />"
- Response.Write "13567.8977 = " & FormatCurrency(13567.8977) & "<br />"
- Response.Write "30000 = " & FormatCurrency(30000) & "<br />"
- Response.Write "30000.587,2 = " & FormatCurrency(30000.587,2) & "<br />"
- Response.Write "30000.587,2,,,0 = " & FormatCurrency(30000.587,2,,,0) & "<br />"
- Response.Write "31567 = " & FormatCurrency(31567) & "<br />"
- Response.Write "31567.9877 = " & FormatCurrency(31567.9877) & "<br />"
- %>
on obtiendra le résultat suivant :
10000 = 10 000,00 €10000.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