Object.prototype.toLocaleString()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Die toLocaleString()
-Methode von Object
-Instanzen gibt eine Zeichenkette zurück, die dieses Objekt repräsentiert. Diese Methode ist dafür vorgesehen, von abgeleiteten Objekten für lokalisierungsspezifische Zwecke überschrieben zu werden.
Probieren Sie es aus
const date1 = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
console.log(date1.toLocaleString("ar-EG"));
// Expected output: "٢٠/١٢/٢٠١٢ ٤:٠٠:٠٠ ص"
const number1 = 123456.789;
console.log(number1.toLocaleString("de-DE"));
// Expected output: "123.456,789"
Syntax
toLocaleString()
Parameter
Keine. Allerdings sollten alle Objekte, die diese Methode überschreiben, maximal zwei Parameter akzeptieren, die locales
und options
entsprechen, wie beispielsweise Number.prototype.toLocaleString
. Die Parameterpositionen sollten keinen anderen Zwecken dienen.
Rückgabewert
Der Rückgabewert des Aufrufs von this.toString()
.
Beschreibung
Alle Objekte, die von Object.prototype
erben (das heißt alle, außer null
-Prototype Objects), erben die toLocaleString()
-Methode. Die Methode toLocaleString
von Object
gibt das Ergebnis des Aufrufs von this.toString()
zurück.
Diese Funktion dient dazu, Objekten eine generische toLocaleString
-Methode bereitzustellen, auch wenn nicht alle diese nutzen. Im Kern der Sprache überschreiben folgende eingebaute Objekte toLocaleString
, um eine lokalisierungsspezifische Formatierung bereitzustellen:
Beispiele
Verwendung der Basis-toLocaleString()-Methode
Die Basis-toLocaleString()
-Methode ruft einfach toString()
auf.
const obj = {
toString() {
return "My Object";
},
};
console.log(obj.toLocaleString()); // "My Object"
Überschreiben von Array toLocaleString()
Array.prototype.toLocaleString()
wird verwendet, um Array-Werte als Zeichenkette auszugeben, indem die toLocaleString()
-Methode jedes Elements aufgerufen und die Ergebnisse mit einem lokalisierungsspezifischen Trennzeichen verbunden werden. Zum Beispiel:
const testArray = [4, 7, 10];
const euroPrices = testArray.toLocaleString("fr", {
style: "currency",
currency: "EUR",
});
// "4,00 €,7,00 €,10,00 €"
Überschreiben von Date toLocaleString()
Date.prototype.toLocaleString()
wird verwendet, um Datumsausgaben zu erstellen, die für bestimmte Lokalisierungen besser geeignet sind. Zum Beispiel:
const testDate = new Date();
// "Fri May 29 2020 18:04:24 GMT+0100 (British Summer Time)"
const deDate = testDate.toLocaleString("de");
// "29.5.2020, 18:04:24"
const frDate = testDate.toLocaleString("fr");
// "29/05/2020, 18:04:24"
Überschreiben von Number toLocaleString()
Number.prototype.toLocaleString()
wird verwendet, um Zahlendarstellungen zu erstellen, die für spezifische Lokalisierungen geeigneter sind, z. B. mithilfe der korrekten Trennzeichen. Zum Beispiel:
const testNumber = 2901234564;
// "2901234564"
const deNumber = testNumber.toLocaleString("de");
// "2.901.234.564"
const frNumber = testNumber.toLocaleString("fr");
// "2 901 234 564"
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-object.prototype.tolocalestring |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toLocaleString |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support