La propriété Intl.NumberFormat.prototype.format renvoie un accesseur vers une fonction qui permet de formater les nombres 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 renvoyée par l'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

Spécification État Commentaires
ECMAScript Internationalization API 1.0 (ECMA-402)
La définition de 'Intl.NumberFormat.prototype.format' dans cette spécification.
Standard Définition initiale
ECMAScript Internationalization API 2.0 (ECMA-402)
La définition de 'Intl.NumberFormat.prototype.format' dans cette spécification.
Standard  
ECMAScript Internationalization API 4.0 (ECMA-402)
La définition de 'Intl.NumberFormat.prototype.format' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet 24Edge Support complet OuiFirefox Support complet 29IE Support complet 11Opera Support complet 15Safari Support complet 10WebView Android Aucun support NonChrome Android Support complet 26Edge Mobile Support complet OuiFirefox Android Support complet 56Opera Android ? Safari iOS Support complet 10Samsung Internet Android Support complet Ouinodejs ?

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,