Array.prototype.toLocaleString()

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

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 hier übergeben werden kann, hängt davon ab, welche Elemente umgewandelt werden. Zum Beispiel, für Zahlen siehe Number.prototype.toLocaleString().

Rückgabewert

Ein String, der die Elemente des Arrays darstellt.

Beschreibung

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 ",").

Wenn ein Element undefined oder null ist, wird es in einen leeren String umgewandelt, anstatt in die Strings "null" oder "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.

Beispiele

Verwendung von locales und options

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:

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 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"

Verwendung von toLocaleString() auf dünn besetzten Arrays

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

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

Aufrufen von toLocaleString() auf Nicht-Array-Objekten

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

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()