Intl.NumberFormat

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⁩.

* Some parts of this feature may have varying levels of support.

DasIntl.NumberFormat Objekt ermöglicht die sprachsensible Formatierung von Zahlen.

Probieren Sie es aus

const number = 123456.789;console.log(  new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(    number,  ),);// Expected output: "123.456,79 €"// The Japanese yen doesn't use a minor unitconsole.log(  new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(    number,  ),);// Expected output: "￥123,457"// Limit to three significant digitsconsole.log(  new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(    number,  ),);// Expected output: "1,23,000"

Konstruktor

Intl.NumberFormat(): Erstellt ein neuesNumberFormat Objekt.

Statische Methoden

Intl.NumberFormat.supportedLocalesOf(): Gibt ein Array mit den angegebenen Locales zurück, die unterstützt werden können, ohne auf die Standard-Locale der Laufzeitumgebung zurückzufallen.

Instanz-Eigenschaften

Diese Eigenschaften sind aufIntl.NumberFormat.prototype definiert und werden von allenIntl.NumberFormat Instanzen geteilt.

Intl.NumberFormat.prototype.constructor: Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. FürIntl.NumberFormat Instanzen ist der Anfangswert derIntl.NumberFormat Konstruktor.
Intl.NumberFormat.prototype[Symbol.toStringTag]: Der Anfangswert der[Symbol.toStringTag] Eigenschaft ist der String"Intl.NumberFormat". Diese Eigenschaft wird inObject.prototype.toString() verwendet.

Instanz-Methoden

Intl.NumberFormat.prototype.format(): Getter-Funktion, die eine Zahl gemäß der Locale und den Formatierungsoptionen diesesIntl.NumberFormat Objekts formatiert.
Intl.NumberFormat.prototype.formatRange(): Getter-Funktion, die eine Zahlenspan gemäß der Locale und den Formatierungsoptionen desIntl.NumberFormat Objekts formatiert, von dem die Methode aufgerufen wird.
Intl.NumberFormat.prototype.formatRangeToParts(): Gibt einArray von Objekten zurück, das die Zahlenspann als Teile darstellt, die für eine benutzerdefinierte, locale-abhängige Formatierung verwendet werden können.
Intl.NumberFormat.prototype.formatToParts(): Gibt einArray von Objekten zurück, das die Zahlenzeichenfolge als Teile darstellt, die für eine benutzerdefinierte, locale-abhängige Formatierung verwendet werden können.
Intl.NumberFormat.prototype.resolvedOptions(): Gibt ein neues Objekt mit Eigenschaften zurück, die die Locale und Kollationsoptionen widerspiegeln, die während der Initialisierung des Objekts berechnet wurden.

Beispiele

Grundlegende Verwendung

Bei der grundlegenden Verwendung ohne Angabe einer Locale wird eine formatierte Zeichenfolge in der Standard-Locale und mit Standardeinstellungen zurückgegeben.

const number = 3500;console.log(new Intl.NumberFormat().format(number));// '3,500' if in US English locale

Dieses Beispiel zeigt einige der Variationen in lokalisierten Zahlenformaten. Um das Format der in der Benutzeroberfläche Ihrer Anwendung verwendeten Sprache zu erhalten, geben Sie sicher diese Sprache (und möglicherweise einige Ersatzsprachen) mit dem Argumentlocales an:

const number = 123456.789;// German uses comma as decimal separator and period for thousandsconsole.log(new Intl.NumberFormat("de-DE").format(number));// 123.456,789// Arabic in most Arabic speaking countries uses real Arabic digitsconsole.log(new Intl.NumberFormat("ar-EG").format(number));// ١٢٣٤٥٦٫٧٨٩// India uses thousands/lakh/crore separatorsconsole.log(new Intl.NumberFormat("en-IN").format(number));// 1,23,456.789// the nu extension key requests a numbering system, e.g. Chinese decimalconsole.log(new Intl.NumberFormat("zh-Hans-CN-u-nu-hanidec").format(number));// 一二三,四五六.七八九// when requesting a language that may not be supported, such as// Balinese, include a fallback language, in this case Indonesianconsole.log(new Intl.NumberFormat(["ban", "id"]).format(number));// 123.456,789

Verwendung von Optionen

Die Ergebnisse können mit demoptions Argument angepasst werden:

const number = 123456.789;// request a currency formatconsole.log(  new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(    number,  ),);// 123.456,79 €// the Japanese yen doesn't use a minor unitconsole.log(  new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(    number,  ),);// ￥123,457// limit to three significant digitsconsole.log(  new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(    number,  ),);// 1,23,000// Formatting with unitsconsole.log(  new Intl.NumberFormat("pt-PT", {    style: "unit",    unit: "kilometer-per-hour",  }).format(50),);// 50 km/hconsole.log(  (16).toLocaleString("en-GB", {    style: "unit",    unit: "liter",    unitDisplay: "long",  }),);// 16 litres

Eine vollständige Liste der Optionen finden Sie auf der Seite desIntl.NumberFormat() Konstruktors.