Baseline Widely available
Die toLocaleString() Methode von BigInt-Werten gibt eine Zeichenfolge 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 Lokalisierungszeichenfolgen durchgeführt werden, was potenziell ineffizient ist. Wenn die Methode häufig mit denselben Argumenten aufgerufen wird, ist es besser, ein Intl.NumberFormat-Objekt zu erstellen und dessen format()-Methode zu verwenden, da ein NumberFormat-Objekt die übergebenen Argumente speichert und möglicherweise einen Teil der Datenbank zwischenspeichern kann, sodass zukünftige format-Aufrufe innerhalb eines eingeschränkteren Kontexts nach Lokalisierungszeichenfolgen suchen können.
const bigint = 123456789123456789n;
// German uses period for thousands
console.log(bigint.toLocaleString("de-DE"));
// Expected output: "123.456.789.123.456.789"
// Request a currency format
console.log(
bigint.toLocaleString("de-DE", { style: "currency", currency: "EUR" }),
);
// Expected output: "123.456.789.123.456.789,00 â¬"
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
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 Unterstützung für Intl.NumberFormat sollen beide Parameter ignorieren, wodurch die verwendete Locale und die Form der zurückgegebenen Zeichenfolge vollständig implementierungsabhängig werden.
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 Unterstützung für Intl.NumberFormat wird dieser Parameter ignoriert und normalerweise die Locale des Hosts verwendet.
options Optional
Ein Objekt, welches das Ausgabeformat anpasst. Entspricht dem options-Parameter des Intl.NumberFormat() Konstruktors.
In Implementierungen ohne Unterstützung für Intl.NumberFormat wird dieser Parameter ignoriert.
Details zu diesen Parametern und ihrer Verwendung finden Sie im Intl.NumberFormat()-Konstruktor.
Eine Zeichenfolge, die das angegebene BigInt gemäà sprachspezifischer Konventionen darstellt.
In Implementierungen mit Intl.NumberFormat ist dies äquivalent zu new Intl.NumberFormat(locales, options).format(number).
Hinweis: Meistens ist die von toLocaleString() zurückgegebene Formatierung konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, selbst innerhalb derselben Locale â Ausgabevariationen sind beabsichtigt und durch die Spezifikation erlaubt. Es kann auch sein, dass sie nicht den Erwartungen entspricht. Beispielsweise kann die Zeichenfolge geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString() nicht mit hartcodierten Konstanten vergleichen.
Die grundlegende Verwendung dieser Methode ohne Angabe einer locale gibt eine formatierte Zeichenfolge in der Standard-Locale und mit Standardeinstellungen zurück.
const bigint = 3500n;
console.log(bigint.toLocaleString());
// "3,500" if in U.S. English locale
Die locales und options Parameter werden möglicherweise nicht in allen Implementierungen unterstützt, da die Unterstützung für die 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-Locale, die möglicherweise nicht den Anforderungen entspricht. Da jede Implementierung, die die locales und options Parameter unterstützt, die Intl-API unterstützen muss, können Sie deren Existenz prüfen, um Unterstützung zu erkennen:
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 Fallback-Sprachen) durch das 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
Die von toLocaleString() bereitgestellten Ergebnisse 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
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4