Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Intl.NumberFormat — formatage des nombres selon la locale

Intl.NumberFormat convertit les nombres en texte à partir d’une locale et d’options de formatage. Il permet de contrôler notamment le groupement des chiffres et le nombre de décimales ; format renvoie une fonction liée à un formateur précis.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);

Intl.NumberFormat crée un formateur de nombres à partir de locales et options. Cette API relève d’ECMA-402, et non de l’API DOM. Le formatage produit du texte destiné à l’affichage, pas une nouvelle valeur numérique ni un analyseur de nombres localisés.

Intl.NumberFormat.prototype.format est une propriété accesseur : sa lecture depuis une instance renvoie une fonction liée à cette instance. Ainsi, const format = formatter.format permet ensuite d’appeler format(value) sans perdre les paramètres. Le même formateur peut être réutilisé pour plusieurs valeurs.

minimumFractionDigits définit le nombre minimal et maximumFractionDigits le nombre maximal de chiffres après le séparateur décimal. Lorsque ces limites s’appliquent, les fixer toutes les deux à 2 affiche deux chiffres après le séparateur décimal avec le réglage par défaut trailingZeroDisplay: "auto", en arrondissant si nécessaire. Avec trailingZeroDisplay: "stripIfInteger", les zéros après le séparateur décimal sont omis si le résultat arrondi est un entier. Avec le réglage par défaut roundingPriority: "auto", si maximumSignificantDigits est renseigné, le formateur ignore les deux limites du nombre de décimales. useGrouping: false désactive le groupement. Le style currency exige une option currency, mais ne convertit pas les taux de change.

L’exemple sélectionne explicitement en-US et les chiffres latn. La disponibilité des locales et les détails de formatage peuvent dépendre de l’implémentation et de ses données de locale. Vérifiez le résultat dans le navigateur cible ; la disponibilité dans Node 24 ne prouve pas la prise en charge par un navigateur.

Exemples

const formatter = new Intl.NumberFormat("en-US", {
  numberingSystem: "latn",
  useGrouping: false,
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));

Résultat

1234.50

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources