BigInt.prototype.toLocaleString()
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.
Die toLocaleString()
Methode von BigInt
Werten gibt einen String mit einer sprachsensitiven Darstellung dieses BigInt zurück. In Implementierungen mit Unterstützung der Intl.NumberFormat
API delegiert diese Methode an Intl.NumberFormat
.
Jedes Mal, wenn toLocaleString
aufgerufen wird, muss eine Suche in einer großen Datenbank von Lokalisierungsstrings durchgeführt werden, was potenziell ineffizient ist. Wenn die Methode mit denselben Argumenten häufig aufgerufen wird, ist es besser, ein Intl.NumberFormat
Objekt zu erstellen und dessen format()
Methode zu verwenden, da ein NumberFormat
Objekt sich die übergebenen Argumente merkt und sich entscheiden kann, einen Teil der Datenbank im Cache zu behalten, sodass zukünftige format
-Aufrufe nach Lokalisierungsstrings in einem eingeschränkteren Kontext suchen können.
Probieren Sie es aus
Syntax
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Parameter
Die locales
- und options
-Parameter passen das Verhalten der Funktion an und ermöglichen es Anwendungen, die Sprache anzugeben, 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 Unterstützung für Intl.NumberFormat
werden gebeten, beide Parameter zu ignorieren, sodass die verwendete Locale und die Form des zurückgegebenen Strings vollständig von der Implementierung abhängen.
locales
Optional-
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem
locales
Parameter desIntl.NumberFormat()
Konstruktors.In Implementierungen ohne Unterstützung für
Intl.NumberFormat
wird dieser Parameter ignoriert und normalerweise wird die Locale des Hosts verwendet. options
Optional-
Ein Objekt, das das Ausgabeformat anpasst. Entspricht dem
options
Parameter desIntl.NumberFormat()
Konstruktors.In Implementierungen ohne Unterstützung für
Intl.NumberFormat
wird dieser Parameter ignoriert.
Details zu diesen Parametern und deren Verwendung finden Sie im Intl.NumberFormat()
Konstruktors.
Rückgabewert
Ein String, der den angegebenen BigInt gemäß sprachspezifischen Konventionen darstellt.
In Implementierungen mit Intl.NumberFormat
entspricht dies new Intl.NumberFormat(locales, options).format(number)
.
Hinweis:
Meistens ist die Formatierung, die von toLocaleString()
zurückgegeben wird, konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, selbst innerhalb derselben Locale — Variationen in der Ausgabe sind gewollt und durch die Spezifikation erlaubt. Es entspricht möglicherweise auch nicht Ihren Erwartungen. Zum Beispiel kann der String nicht-brechende Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString()
nicht mit fest kodierten Konstanten vergleichen.
Beispiele
Verwendung von toLocaleString()
Die grundlegende Verwendung dieser Methode ohne Angabe einer locale
gibt einen formatierten String in der Standard-Locale und mit Standardeinstellungen zurück.
const bigint = 3500n;
console.log(bigint.toLocaleString());
// "3,500" if in U.S. English locale
Überprüfung der Unterstützung für locales
und options
Parameter
Die locales
- und options
-Parameter 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 Locale des Systems, was möglicherweise nicht dem entspricht, was Sie möchten. Da jede Implementierung, die die locales
- und options
-Parameter unterstützt, auch die Intl
API unterstützen muss, können Sie die Existenz dieser testen, um die Unterstützung zu prüfen:
function toLocaleStringSupportsLocales() {
return (
typeof Intl === "object" &&
!!Intl &&
typeof Intl.NumberFormat === "function"
);
}
Verwendung von locales
Dieses Beispiel zeigt einige der Unterschiede 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 Ersatzsprachen) mit dem locales
Argument angeben:
const bigint = 123456789123456789n;
// German uses period for thousands
console.log(bigint.toLocaleString("de-DE"));
// 123.456.789.123.456.789
// Arabic in most Arabic speaking countries uses Eastern Arabic digits
console.log(bigint.toLocaleString("ar-EG"));
// ١٢٣٬٤٥٦٬٧٨٩٬١٢٣٬٤٥٦٬٧٨٩
// India uses thousands/lakh/crore separators
console.log(bigint.toLocaleString("en-IN"));
// 1,23,45,67,89,12,34,56,789
// the nu extension key requests a numbering system, e.g. Chinese decimal
console.log(bigint.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(bigint.toLocaleString(["ban", "id"]));
// 123.456.789.123.456.789
Verwendung von Optionen
Die Ergebnisse, die von toLocaleString()
bereitgestellt werden, können mit dem options
Parameter angepasst werden:
const bigint = 123456789123456789n;
// request a currency format
console.log(
bigint.toLocaleString("de-DE", { style: "currency", currency: "EUR" }),
);
// 123.456.789.123.456.789,00 €
// the Japanese yen doesn't use a minor unit
console.log(
bigint.toLocaleString("ja-JP", { style: "currency", currency: "JPY" }),
);
// ¥123,456,789,123,456,789
// limit to three significant digits
console.log(bigint.toLocaleString("en-IN", { maximumSignificantDigits: 3 }));
// 1,23,00,00,00,00,00,00,000
Spezifikationen
Specification |
---|
ECMAScript® 2025 Internationalization API Specification # sup-bigint.prototype.tolocalestring |
Browser-Kompatibilität
BCD tables only load in the browser