Intl.NumberFormat.prototype.format

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.

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi