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. Fr 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, hngt davon ab, welche Elemente umgewandelt werden. Zum Beispiel, fr Zahlen siehe Number.prototype.toLocaleString().

Rckgabewert

Ein String, der die Elemente des Arrays darstellt.

Beschreibung

Die Methode Array.prototype.toLocaleString durchluft 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 dnn besetzten Arrays iteriert die Methode toLocaleString() ber leere Stellen, als ob sie den Wert undefined htten.

Die toLocaleString() Methode ist generisch. Sie erwartet nur, dass der this Wert eine length Eigenschaft und integer-schlsselbezogene 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 Whrung fr 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,8889,999"

Verwendung von toLocaleString() auf dnn besetzten Arrays

toLocaleString() behandelt leere Pltze genauso wie undefined und erzeugt einen zustzlichen 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 Schlssel 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-Kompatibilitt

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