DietoLocaleString() Methode vonArray Instanzen gibt einen String zurück, der die Elemente des Arrays darstellt. Die Elemente werden unter Verwendung ihrertoLocaleString Methoden in Strings umgewandelt, und diese Strings werden durch einen lokal spezifischen String (wie ein Komma ",") getrennt.

Probieren Sie es aus

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

Syntax

toLocaleString()toLocaleString(locales)toLocaleString(locales, options)

Parameter

localesOptional

Ein String mit einemBCP 47 Sprach-Tag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation deslocales Arguments, siehedie Parameterbeschreibung auf derIntl Hauptseite.

optionsOptional

Ein Objekt mit Konfigurationseigenschaften. Was hier übergeben werden kann, hängt davon ab, welche Elemente umgewandelt werden. Zum Beispiel, für Zahlen sieheNumber.prototype.toLocaleString().

Rückgabewert

Ein String, der die Elemente des Arrays darstellt.

Beschreibung

Die MethodeArray.prototype.toLocaleString durchläuft ihren Inhalt, ruft dietoLocaleString Methode jedes Elements mit den übergebenenlocales undoptions Parametern auf und verkettet sie mit einem implementierungsdefinierten Separator (wie einem Komma ",").

Wenn ein Elementundefined odernull ist, wird es in einen leeren String umgewandelt, anstatt in die Strings"null" oder"undefined".

Bei Verwendung aufdünn besetzten Arrays iteriert die MethodetoLocaleString() über leere Stellen, als ob sie den Wertundefined hätten.

DietoLocaleString() Methode istgenerisch. Sie erwartet nur, dass derthis Wert einelength Eigenschaft und integer-schlüsselbezogene Eigenschaften hat.

Beispiele

Verwendung von locales und options

Die Elemente des Arrays werden unter Verwendung ihrertoLocaleString Methoden in Strings umgewandelt. Zum Beispiel ruft dieses Snippet implizit dieNumber.prototype.toLocaleString() Methode auf, um die Währung für die Strings und Zahlen imprices Array anzuzeigen:

const prices = ["￥7", 500, 8123, 12];prices.toLocaleString("ja-JP", { style: "currency", currency: "JPY" });// "￥7,￥500,￥8,123,￥12"

Listenseparatoren

Der Listenseparator wird nicht durch denlocales Parameter beeinflusst. Um ihn zu konfigurieren, verwenden Sie stattdessenIntl.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"

Verwendung von toLocaleString() auf dünn besetzten Arrays

toLocaleString() behandelt leere Plätze genauso wieundefined und erzeugt einen zusätzlichen Separator:

console.log([1, , 3].toLocaleString()); // '1,,3'

Aufrufen von toLocaleString() auf Nicht-Array-Objekten

DietoLocaleString() Methode liest dielength Eigenschaft vonthis und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nichtnegative ganze Zahl kleiner alslength 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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Indizierte Sammlungen Leitfaden
• Array
• Array.prototype.toString()
• TypedArray.prototype.toLocaleString()
• Intl
• Intl.ListFormat
• Object.prototype.toLocaleString()
• Number.prototype.toLocaleString()
• Temporal.PlainDate.prototype.toLocaleString()