Baseline Widely available
Die toLocaleString() Methode von Number Werten gibt eine zeichenkettenbasierte, sprachsensitive Darstellung dieser Zahl 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 mehrfach mit denselben Argumenten 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 möglicherweise einen Teil der Datenbank zwischenspeichert, sodass zukünftige format Aufrufe innerhalb eines eingeschränkteren Kontexts nach Lokalisierungszeichenfolgen suchen können.
function eArabic(x) {
return x.toLocaleString("ar-EG");
}
console.log(eArabic(123456.789));
// Expected output: "١٢٣٬٤٥٦٫٧٨٩"
console.log(eArabic("123456.789"));
// Expected output: "123456.789"
console.log(eArabic(NaN));
// Expected output: "ÙÙس رÙÙ
"
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 exakt den Parametern des Intl.NumberFormat() Konstruktors. Implementierungen ohne Intl.NumberFormat Unterstützung werden gebeten, beide Parameter zu ignorieren, wodurch die verwendete Locale und die Form der zurückgegebenen Zeichenkette vollständig implementierungsabhängig werden.
locales Optional
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem locales Parameter des Intl.NumberFormat() Konstruktors.
In Implementierungen ohne Intl.NumberFormat Unterstützung wird dieser Parameter ignoriert und normalerweise die Locale des Hosts verwendet.
options Optional
Ein Objekt, das das Ausgabeformat anpasst. Entspricht dem options Parameter des Intl.NumberFormat() Konstruktors.
In Implementierungen ohne Intl.NumberFormat Unterstützung wird dieser Parameter ignoriert.
Siehe den Intl.NumberFormat() Konstruktor für Details zu diesen Parametern und deren Verwendung.
Eine Zeichenkette, die die gegebene Zahl nach sprachspezifischen Konventionen darstellt.
In Implementierungen mit Intl.NumberFormat entspricht dies new Intl.NumberFormat(locales, options).format(number).
Hinweis: Die durch toLocaleString() zurückgegebene Formatierung ist meistens konsistent. Es kann jedoch zu Abweichungen zwischen Implementierungen kommen, sogar innerhalb derselben Locale â Variationen der Ausgabe sind absichtlich und durch die Spezifikation erlaubt. Es könnte auch nicht das sein, was Sie erwarten. Zum Beispiel kann die Zeichenkette geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString() nicht mit hartkodierten Konstanten vergleichen.
Der grundlegende Gebrauch dieser Methode ohne Angabe einer locale gibt eine formatierte Zeichenkette in der Standard-Locale 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 sind 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 die erforderlichen Daten haben. Für Implementierungen ohne Unterstützung für Internationalisierung verwendet toLocaleString() immer die Locale des Systems, was möglicherweise nicht Ihren Wünschen entspricht. Da jede Implementierung, die die Parameter locales und options unterstützt, die Intl API unterstützen muss, können Sie die Existenz der letzteren für 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 Fallback-Sprachen) 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
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