Array.prototype.toLocaleString()

locales Optional

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.

options Optional

Ein Objekt mit Konfigurationseigenschaften. Was Sie hier übergeben können, hängt davon ab, welche Elemente umgewandelt werden. Für Zahlen, siehe zum Beispiel Number.prototype.toLocaleString().

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

Die Methode Array.prototype.toLocaleString() durchläuft ihre Inhalte, ruft die toLocaleString Methode jedes Elements mit den angegebenen locales und options Parametern auf und verknüpft sie mit einem implementierungsdefinierten Trennzeichen (wie einem Komma ","). Beachten Sie, dass die Methode selbst die beiden Parameter nicht verbraucht – sie übergibt sie nur an die toLocaleString() Methode jedes Elements. Die Wahl des Trennzeichenstrings hängt von der aktuellen Locale des Hosts ab, nicht vom locales-Parameter.

Wenn ein Element undefined oder null ist, wird es in einen leeren String umgewandelt, anstatt in den String "null" oder "undefined".

Bei der Verwendung auf sparschen Arrays durchläuft die Methode toLocaleString() leere Slots, als hätten sie den Wert undefined.

Die Methode toLocaleString() ist generisch. Sie erwartet nur, dass der this Wert eine length Eigenschaft und Integer-indizierte Eigenschaften besitzt.

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

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

// "￥7,￥500,￥8,123,￥12"

toLocaleString() behandelt leere Slots genauso wie undefined und erzeugt ein zusätzliches Trennzeichen:

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

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