Number.prototype.toLocaleString()

Die Parameter locales und options passen das Verhalten der Funktion an und ermöglichen es Anwendungen, die Sprache zu spezifizieren, deren Formatierungskonventionen verwendet werden sollen.

In Implementierungen, die die Intl.NumberFormat API unterstützen, entsprechen diese Parameter genau den Parametern des Intl.NumberFormat() Konstruktors. Implementierungen ohne Intl.NumberFormat Unterstützung sollten beide Parameter ignorieren, wodurch die verwendete Sprache und die Form der zurückgegebenen Zeichenfolge vollständig implementierungsabhängig sind.

locales Optional

Eine Zeichenfolge mit einem BCP 47 Sprach-Tag oder ein Array solcher Zeichenfolgen. Entspricht dem locales Parameter des Intl.NumberFormat() Konstruktors.

In Implementierungen ohne Intl.NumberFormat Unterstützung wird dieser Parameter ignoriert und normalerweise die Sprache des Hosts verwendet.

options Optional

Ein Objekt zur Anpassung des Ausgabeformats. Entspricht dem options Parameter des Intl.NumberFormat() Konstruktors.

In Implementierungen ohne Intl.NumberFormat Unterstützung wird dieser Parameter ignoriert.

Details zu diesen Parametern und ihrer Anwendung finden Sie im Intl.NumberFormat() Konstruktor.

Eine Zeichenfolge, die die gegebene Zahl gemäß sprachspezifischen Konventionen darstellt.

In Implementierungen mit Intl.NumberFormat entspricht dies new Intl.NumberFormat(locales, options).format(number).

Die grundlegende Nutzung dieser Methode ohne Angabe einer locale gibt eine formatierte Zeichenfolge in der Standardsprache und mit Standardoptionen zurück.

const number = 3500;

console.log(number.toLocaleString()); // "3,500" if in U.S. English locale

Die Parameter locales und options werden möglicherweise nicht in allen Implementierungen unterstützt, da die Unterstützung der Internationalisierungs-API optional ist und einige Systeme möglicherweise nicht über die erforderlichen Daten verfügen. Für Implementierungen ohne Internationalisierungsunterstützung verwendet toLocaleString() immer die System-Standardsprache, was möglicherweise nicht das gewünschte Ergebnis liefert. Da jede Implementierung, die die locales und options Parameter unterstützt, auch die Intl API unterstützen muss, können Sie deren Existenz für die Unterstützung überprüfen:

function toLocaleStringSupportsLocales() {
  return (
    typeof Intl === "object" &&
    !!Intl &&
    typeof Intl.NumberFormat === "function"
  );
}

Dieses Beispiel zeigt einige der Variationen in lokalisierten Zahlenformaten. Um das Format der Sprache zu erhalten, die in der Benutzeroberfläche Ihrer Anwendung verwendet wird, stellen Sie sicher, dass Sie diese Sprache (und möglicherweise einige Ausweichsprachen) mit dem locales Argument angeben:

const number = 123456.789;

// German uses comma as decimal separator and period for thousands
console.log(number.toLocaleString("de-DE"));
// 123.456,789

// Arabic in most Arabic speaking countries uses Eastern Arabic digits
console.log(number.toLocaleString("ar-EG"));
// ١٢٣٤٥٦٫٧٨٩

// India uses thousands/lakh/crore separators
console.log(number.toLocaleString("en-IN"));
// 1,23,456.789

// the nu extension key requests a numbering system, e.g. Chinese decimal
console.log(number.toLocaleString("zh-Hans-CN-u-nu-hanidec"));
// 一二三,四五六.七八九

// when requesting a language that may not be supported, such as
// Balinese, include a fallback language, in this case Indonesian
console.log(number.toLocaleString(["ban", "id"]));
// 123.456,789

Die von toLocaleString() bereitgestellten Ergebnisse können mit dem options Parameter angepasst werden:

const number = 123456.789;

// request a currency format
console.log(
  number.toLocaleString("de-DE", { style: "currency", currency: "EUR" }),
);
// 123.456,79 €

// the Japanese yen doesn't use a minor unit
console.log(
  number.toLocaleString("ja-JP", { style: "currency", currency: "JPY" }),
);
// ￥123,457

// limit to three significant digits
console.log(number.toLocaleString("en-IN", { maximumSignificantDigits: 3 }));
// 1,23,000

// Use the host default language with options for number formatting
const num = 30000.65;
console.log(
  num.toLocaleString(undefined, {
    minimumFractionDigits: 2,
    maximumFractionDigits: 2,
  }),
);
// "30,000.65" where English is the default language, or
// "30.000,65" where German is the default language, or
// "30 000,65" where French is the default language

• Intl.NumberFormat
• Number.prototype.toString()