Intl.NumberFormat - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Intl.NumberFormat

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2017.

L'objet Intl.NumberFormat permet de formater des nombres en fonction de la locale.

Dans cet article

Exemple interactif

const number = 123456.789;

console.log(
  new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(
    number,
  ),
);
// Résultat attendu : "123.456,79 €"

// Le yen japonais n'utilise pas d'unité mineure
console.log(
  new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(
    number,
  ),
);
// Résultat attendu : "￥123,457"

// Limiter à trois chiffres significatifs
console.log(
  new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(
    number,
  ),
);
// Résultat attendu : "1,23,000"

Constructeur

Intl.NumberFormat()

Crée un nouvel objet NumberFormat.

Méthodes statiques

Intl.NumberFormat.supportedLocalesOf()

Retourne un tableau qui contient les locales, parmi celles fournies en arguments, qui sont prises en charge sans avoir à recourir à la locale par défaut de l'environnement d'exécution.

Propriétés d'instance

Ces propriétés sont définies sur Intl.NumberFormat.prototype et partagées par toutes les instances de Intl.NumberFormat.

Intl.NumberFormat.prototype.constructor

La fonction constructeur qui a créé l'instance de l'objet. Pour les instances de Intl.NumberFormat, la valeur initiale est le constructeur Intl.NumberFormat.

Intl.NumberFormat.prototype[Symbol.toStringTag]

La valeur initiale de la propriété [Symbol.toStringTag] est la chaîne de caractères "Intl.NumberFormat". Cette propriété est utilisée dans Object.prototype.toString().

Méthodes d'instance

Intl.NumberFormat.prototype.format()

La fonction accesseur qui formate un nombre selon la locale et les options de formatage de cet objet Intl.NumberFormat.

Intl.NumberFormat.prototype.formatRange()

La fonction accesseur qui formate une plage de nombres selon la locale et les options de formatage de l'objet Intl.NumberFormat à partir duquel la méthode est appelée.

Intl.NumberFormat.prototype.formatRangeToParts()

Retourne un tableau (Array) d'objets représentant la plage de chaînes de caractères de nombres, en parties pouvant être utilisées pour un formatage personnalisé sensible à la locale.

Intl.NumberFormat.prototype.formatToParts()

Retourne un tableau (Array) d'objets représentant la chaîne de caractères du nombre, en parties pouvant être utilisées pour un formatage personnalisé sensible à la locale.

Intl.NumberFormat.prototype.resolvedOptions()

Retourne un nouvel objet avec des propriétés reflétant la locale et les options de collation calculées lors de l'initialisation de l'objet.

Exemples

Utilisation simple

Sans indiquer de locale ou d'options, le résultat sera une chaîne de caractères avec la locale et les options par défaut :

js
const nombre = 3500;

console.log(new Intl.NumberFormat().format(nombre));
// "3 500" pour la locale fr

Cet exemple illustre les variations possibles des formats numériques localisés. Si vous souhaitez que votre application utilise le format de la locale de l'utilisateur, assurez vous de l'indiquer via l'argument locales (voire avec d'autres locales de secours) :

js
const nombre = 123456.789;

// L'allemand utilise la virgule comme séparateur décimal
// et un point pour indiquer les milliers
console.log(new Intl.NumberFormat("de-DE").format(nombre));
// 123.456,789

// Dans la plupart des pays arabophones, on utilise les
// chiffres arabo-hindîs
console.log(new Intl.NumberFormat("ar-EG").format(nombre));
// ١٢٣٤٥٦٫٧٨٩

// L'indien utilise des séparateurs pour les milliers,
//les lakhs et les crores
console.log(new Intl.NumberFormat("en-IN").format(nombre));
// 1,23,456.789

// La clé d'extension nu indique une l'utilisation d'un système numérique
// par exemple le système chinois
console.log(new Intl.NumberFormat("zh-Hans-CN-u-nu-hanidec").format(nombre));
// 一二三,四五六.七八九

// Lorsqu'une locale n'est pas supportée (par exemple le balinais)
// on peut inclure une locale de secours (ici l'indonésien)
console.log(new Intl.NumberFormat(["ban", "id"]).format(nombre));
// 123.456,789

Utiliser options

Les résultats fournis peuvent être paramétrés grâce à l'argument options :

js
const nombre = 123456.789;

// on affiche une devise avec le style "currency"
console.log(
  new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(
    nombre,
  ),
);
// 123.456,79 €

// Le yen japonais n'a pas de centimes
console.log(
  new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(
    nombre,
  ),
);
// ￥123,457

// On se limite ici à trois chiffres significatifs
console.log(
  new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(
    nombre,
  ),
);
// 1,23,000

Utiliser les options style et unit

js
console.log(
  new Intl.NumberFormat("pt-PT", {
    style: "unit",
    unit: "kilometer-per-hour",
  }).format(50),
);
// 50 km/h

console.log(
  (16).toLocaleString("en-GB", {
    style: "unit",
    unit: "liter",
    unitDisplay: "long",
  }),
);
// 16 litres

Pour une liste exhaustive des options, voir la page du constructeur Intl.NumberFormat().

Prothèse d'émulation pour Intl.NumberFormat dans FormatJS (angl.)
L'objet Intl
La méthode Number.prototype.toLocaleString()

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 27 avr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Intl.NumberFormat
Constructeur
1. Intl.NumberFormat()
Méthodes statiques
1. supportedLocalesOf()
Méthodes d'instance
1. format()
2. formatRange()
3. formatRangeToParts()
4. formatToParts()
5. resolvedOptions()
Héritage
Object/Function
Méthodes statiques
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Propriétés statiques
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Méthodes d'instance
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor
Pages similaires
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.ListFormat
Intl.Locale
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter