CKTIS / JavaScript
Intl.NumberFormat : options de devise et de pourcentage
Formatez des montants et des proportions selon les paramètres régionaux. Découvrez quand le code de devise est obligatoire, pourquoi 0,125 vaut 12,5 % et comment régler le nombre de décimales.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new Intl.NumberFormat(locale, { style: "currency", currency: "USD" }).format(amount)
new Intl.NumberFormat(locale, { style: "percent", minimumFractionDigits: 1, maximumFractionDigits: 1 }).format(ratio)new Intl.NumberFormat(locale, options) crée un formateur réutilisable ; format(value) renvoie du texte localisé. Les paramètres régionaux influencent notamment les séparateurs et la position des symboles. style sélectionne le type d’affichage et vaut "decimal" par défaut.
Avec style: "currency", indiquez un code comme "USD" dans currency. Passez le montant en unités principales et non en centimes : le formatage ne convertit pas les devises. L’absence de code déclenche une TypeError ; un code qui n’est pas composé de trois lettres ASCII déclenche une RangeError. Un code bien formé n’est pas nécessairement attribué à une devise. currencyDisplay sélectionne "symbol" (par défaut), "narrowSymbol" (symbole court), "code" ou "name". currencySign vaut "standard" par défaut ; "accounting" peut afficher les montants négatifs entre parenthèses selon les paramètres régionaux.
Avec style: "percent", passez une proportion : le formatage la multiplie par 100 avant l’arrondi. Pour afficher 12,5 %, passez 0.125, pas 12.5. En notation standard et sans réglage des chiffres significatifs, le nombre de décimales par défaut dépend de la subdivision de la devise (deux pour USD), tandis que le pourcentage n’a pas de décimales par défaut. minimumFractionDigits ajoute des zéros si nécessaire ; maximumFractionDigits fixe le nombre maximal de décimales pour l’arrondi. Avec le réglage par défaut trailingZeroDisplay: "auto", donnez-leur la même valeur pour afficher exactement ce nombre de décimales. Avec trailingZeroDisplay: "stripIfInteger", la partie décimale est omise si le résultat arrondi est un entier.
Les données régionales et la prise en charge par l’environnement d’exécution peuvent varier. Les espaces et les symboles peuvent différer même pour les mêmes paramètres régionaux : évitez de comparer la chaîne localisée entière à une valeur codée en dur. Utilisez formatToParts() pour examiner les éléments par type.
Exemples
const locale = "en-US-u-nu-latn";
const money = new Intl.NumberFormat(locale, {
style: "currency",
currency: "USD",
currencyDisplay: "code",
});
const percent = new Intl.NumberFormat(locale, {
style: "percent",
minimumFractionDigits: 1,
maximumFractionDigits: 1,
});
const moneyParts = money.formatToParts(19.9);
const percentParts = percent.formatToParts(0.125);
const valueOf = (parts, type) => parts.find(part => part.type === type)?.value;
console.log(JSON.stringify([
valueOf(moneyParts, "currency"),
valueOf(moneyParts, "integer"),
valueOf(moneyParts, "fraction"),
]));
console.log(JSON.stringify([
valueOf(percentParts, "integer"),
valueOf(percentParts, "fraction"),
percentParts.some(part => part.type === "percentSign"),
]));Résultat
["USD","19","90"] ["12","5",true]
La première ligne montre le code USD et les deux parties du montant, dont le zéro final. La seconde montre les parties numériques de 12,5 % et confirme la présence d’un signe de pourcentage, sans vérifier son caractère exact ni sa position.
Leçons associées
- JavaScript · Leçon 24 · Intermédiaire · Version : 3