Intl.NumberFormat.prototype.format

Die Intl.NumberFormat.prototype.format Eigenschaft gibt eine Getterfunktion zurück, die eine Zahl nach den Sprach- und Formatierungsoptionen dieses NumberFormat Objektes formatiert.

Syntax

numberFormat.format(number)

Parameter

number
Zahl, die formatiert werden soll.

Beschreibung

Die Funktion, die von format Getter zurückgegeben wird, formatiert eine Zahl in einen String nach den angegebenen Sprach- und Formatierungsoptionen des NumberFormat Objektes.

Beispiele

Einsatz von format

Einsatz der vom format Getter zurückgegebenen Funktion zum Formatieren eines Währungswertes, hier für Russland:

var options = { style: 'currency', currency: 'RUB' };
var numberFormat = new Intl.NumberFormat('ru-RU', options);
console.log(numberFormat.format(654321.987));
// → "654 321,99 руб."

Einsatz format mit map

Einsatz der vom format Getter zurückgegebenen Funktion zum Formatieren von allen Zahlen in einem Array. Zu bemerken ist, dass die Funktion an das NumberFormat Objekt gebunden ist, von dem sie stammt, so dass es direkt in Array.prototype.map verwendet werden kann.

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"

Spezifikationen

Spezifikation Status Komment
ECMAScript Internationalization API 1.0 (ECMA-402)
Die Definition von 'Intl.NumberFormat.prototype.format' in dieser Spezifikation.
Standard Initiale Definition.
ECMAScript Internationalization API 2.0 (ECMA-402)
Die Definition von 'Intl.NumberFormat.prototype.format' in dieser Spezifikation.
Standard  
ECMAScript Internationalization API (ECMA-402)
Die Definition von 'Intl.NumberFormat.prototype.format' in dieser Spezifikation.
Lebender Standard  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
formatChrome Vollständige Unterstützung 24Edge Vollständige Unterstützung 12
Hinweise
Vollständige Unterstützung 12
Hinweise
Hinweise Before Edge 18, numbers are rounded to 15 decimal digits. For example, new Intl.NumberFormat('en-US').format(1000000000000005) returns "1,000,000,000,000,010".
Firefox Vollständige Unterstützung 29IE Vollständige Unterstützung 11
Hinweise
Vollständige Unterstützung 11
Hinweise
Hinweise In Internet Explorer 11, numbers are rounded to 15 decimal digits. For example, new Intl.NumberFormat('en-US').format(1000000000000005) returns "1,000,000,000,000,010".
Opera Vollständige Unterstützung 15Safari Vollständige Unterstützung 10WebView Android Vollständige Unterstützung 4.4Chrome Android Vollständige Unterstützung 25Firefox Android Vollständige Unterstützung 56Opera Android Vollständige Unterstützung 14Safari iOS Vollständige Unterstützung 10Samsung Internet Android Vollständige Unterstützung 1.5nodejs Vollständige Unterstützung 0.12
Hinweise
Vollständige Unterstützung 0.12
Hinweise
Hinweise Before version 13.0.0, only the locale data for en-US is available by default. See the NumberFormat() constructor for more details.

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.

Siehe auch