HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
View in English Always switch to English
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die toLocaleString() Methode von Array Instanzen gibt einen String zurück, der die Elemente des Arrays darstellt. Die Elemente werden unter Verwendung ihrer toLocaleString Methoden in Strings umgewandelt, und diese Strings werden durch einen lokal spezifischen String (wie ein Komma ",") getrennt.
toLocaleString()
Array
toLocaleString
const array = [1, "a", new Date("21 Dec 1997 14:12:00 UTC")]; const localeString = array.toLocaleString("en", { timeZone: "UTC" }); console.log(localeString); // Expected output: "1,a,12/21/1997, 2:12:00 PM", // This assumes "en" locale and UTC timezone - your results may vary
toLocaleString() toLocaleString(locales) toLocaleString(locales, options)
locales
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des locales Arguments, siehe die Parameterbeschreibung auf der Intl Hauptseite.
Intl
options
Ein Objekt mit Konfigurationseigenschaften. Was hier übergeben werden kann, hängt davon ab, welche Elemente umgewandelt werden. Zum Beispiel, für Zahlen siehe Number.prototype.toLocaleString().
Number.prototype.toLocaleString()
Ein String, der die Elemente des Arrays darstellt.
Die Methode Array.prototype.toLocaleString durchläuft ihren Inhalt, ruft die toLocaleString Methode jedes Elements mit den übergebenen locales und options Parametern auf und verkettet sie mit einem implementierungsdefinierten Separator (wie einem Komma ",").
Array.prototype.toLocaleString
Hinweis: Die Argumente locales oder options steuern nicht den Separator, der zwischen Array-Elementen verwendet wird; sie werden einfach an die toLocaleString() Methode jedes Elements weitergegeben. Der tatsächliche Separator (normalerweise ein Komma) ist allein von der aktuellen Locale des Hosts abhängig. Wenn Sie eine lokalisierte Listenformatierung erwarten, ziehen Sie in Betracht, Intl.ListFormat zu verwenden.
Intl.ListFormat
Wenn ein Element undefined oder null ist, wird es in einen leeren String umgewandelt, anstatt in die Strings "null" oder "undefined".
undefined
null
"null"
"undefined"
Bei Verwendung auf dünn besetzten Arrays iteriert die Methode toLocaleString() über leere Stellen, als ob sie den Wert undefined hätten.
Die toLocaleString() Methode ist generisch. Sie erwartet nur, dass der this Wert eine length Eigenschaft und integer-schlüsselbezogene Eigenschaften hat.
this
length
Die Elemente des Arrays werden unter Verwendung ihrer toLocaleString Methoden in Strings umgewandelt. Zum Beispiel ruft dieses Snippet implizit die Number.prototype.toLocaleString() Methode auf, um die Währung für die Strings und Zahlen im prices Array anzuzeigen:
prices
const prices = ["￥7", 500, 8123, 12]; prices.toLocaleString("ja-JP", { style: "currency", currency: "JPY" }); // "￥7,￥500,￥8,123,￥12"
Der Listenseparator wird nicht durch den locales Parameter beeinflusst. Um ihn zu konfigurieren, verwenden Sie stattdessen Intl.ListFormat.
const nums = [8888, 9999]; console.log(nums.toLocaleString("zh")); // "8,888,9,999" const formatter = new Intl.ListFormat("zh", { type: "conjunction", style: "narrow", }); console.log(formatter.format(nums.map((x) => x.toLocaleString("zh")))); // "8,888、9,999"
toLocaleString() behandelt leere Plätze genauso wie undefined und erzeugt einen zusätzlichen Separator:
console.log([1, , 3].toLocaleString()); // '1,,3'
Die toLocaleString() Methode liest die length Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nichtnegative ganze Zahl kleiner als length ist.
const arrayLike = { length: 3, 0: 1, 1: 2, 2: 3, 3: 4, // ignored by toLocaleString() since length is 3 }; console.log(Array.prototype.toLocaleString.call(arrayLike)); // 1,2,3
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.
Array.prototype.toString()
TypedArray.prototype.toLocaleString()
Object.prototype.toLocaleString()
Temporal.PlainDate.prototype.toLocaleString()