Intl.NumberFormat.prototype.format
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
La méthode Intl.NumberFormat.prototype.format()
formate un nombre en fonction des options de locales et de formats définis dans l'objet Intl.NumberFormat
correspondant.
Exemple interactif
Syntaxe
numberFormat.format(nombre);
Paramètres
nombre
-
Le nombre qu'on souhaite formater.
Description
La fonction d'accesseur format
permet de formater un nombre donné en une chaîne de caractères selon les options de locale et de format de l'objet Intl.NumberFormat
.
Exemples
Utiliser format()
On peut utiliser la fonction renvoyée par format
pour formater une valeur monétaire selon la locale russe :
var options = { style: "currency", currency: "RUB" };
var numberFormat = new Intl.NumberFormat("ru-RU", options);
console.log(numberFormat.format(654321.987));
// → "654 321,99 руб."
Utiliser format()
avec map()
On peut également utiliser la fonction format
pour formater les nombres contenus dans un tableau. On notera que la fonction est liée à l'objet NumberFormat
dont elle provient, on peut donc directement l'utiliser avec Array.prototype.map
.
var a = [123456.789, 987654.321, 456789.123];
var numberFormat = new Intl.NumberFormat("es-ES");
var formatted = a.map(numberFormat.format);
console.log(formatted.join("; "));
// → "123.456,789; 987.654,321; 456.789,123"
Spécifications
Specification |
---|
ECMAScript Internationalization API Specification # sec-intl.numberformat.prototype.format |
Compatibilité des navigateurs
BCD tables only load in the browser