localesOptional

Ein String mit einem BCP 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 konvertiert werden. Zum Beispiel, für Zahlen sieheNumber.prototype.toLocaleString().

Ein String, der die Elemente des Arrays repräsentiert.

DieArray.prototype.toLocaleString Methode durchläuft ihren Inhalt, ruft dietoLocaleString Methode jedes Elements mit den übergebenenlocales undoptions Parametern auf und verknüpft sie mit einem implementierungsabhängigen Trennzeichen (wie ein Komma ",").

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

WenntoLocaleString() fürlückige Arrays verwendet wird, durchläuft die Methode leere Slots, als hätten sie den Wertundefined.

DietoLocaleString() Methode istgenerisch. Sie erwartet lediglich, dass der Wert vonthis einelength Eigenschaft und integer-gekoppelte Eigenschaften hat.

Die Elemente des Arrays werden mithilfe ihrertoLocaleString Methoden in Strings konvertiert. 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"

Das Listentrennzeichen wird nicht durch denlocales Parameter beeinflusst. Um es zu konfigurieren, verwenden SieIntl.ListFormat stattdessen.

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 Slots genau wieundefined und erzeugt einen zusätzlichen Trenner:

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

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

• Leitfaden für indizierte Sammlungen
• Array
• Array.prototype.toString()
• TypedArray.prototype.toLocaleString()
• Intl
• Intl.ListFormat
• Object.prototype.toLocaleString()
• Number.prototype.toLocaleString()
• Temporal.PlainDate.prototype.toLocaleString()