Baseline Widely available
Die toLocaleString() Methode von Array Instanzen gibt einen String zurück, der die Elemente des Arrays repräsentiert. Die Elemente werden mithilfe ihrer toLocaleString Methoden in Strings konvertiert, und diese Strings werden durch einen lokalisierten String (wie ein Komma ",") getrennt.
const array1 = [1, "a", new Date("21 Dec 1997 14:12:00 UTC")];
const localeString = array1.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
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
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 konvertiert werden. Zum Beispiel, für Zahlen siehe Number.prototype.toLocaleString().
Ein String, der die Elemente des Arrays repräsentiert.
BeschreibungDie Array.prototype.toLocaleString Methode durchläuft ihren Inhalt, ruft die toLocaleString Methode jedes Elements mit den übergebenen locales und options Parametern auf und verknüpft sie mit einem implementierungsabhängigen Trennzeichen (wie ein Komma ",").
Hinweis: Die locales oder options Argumente steuern nicht den zwischen den Array-Elementen verwendeten Trennzeichen; sie werden einfach an die toLocaleString() Methode jedes Elements übergeben. Das tatsächliche Trennzeichen (normalerweise ein Komma) hängt ausschlieÃlich von der aktuellen Locale des Hosts ab. Wenn Sie eine lokalisierte Listenformatierung erwarten, ziehen Sie Intl.ListFormat in Betracht.
Wenn ein Element undefined oder null ist, wird es in einen leeren String anstatt des Strings "null" oder "undefined" umgewandelt.
Wenn toLocaleString() für lückige Arrays verwendet wird, durchläuft die Methode leere Slots, als hätten sie den Wert undefined.
Die toLocaleString() Methode ist generisch. Sie erwartet lediglich, dass der Wert von this eine length Eigenschaft und integer-gekoppelte Eigenschaften hat.
Die Elemente des Arrays werden mithilfe ihrer toLocaleString Methoden in Strings konvertiert. 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"
Das Listentrennzeichen wird nicht durch den locales Parameter beeinflusst. Um es zu konfigurieren, verwenden Sie Intl.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 wie undefined und erzeugt einen zusätzlichen Trenner:
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
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4