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 soll von abgeleiteten Objekten für lokalisierungsspezifische Zwecke überschrieben 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 wird von allen Objekten, die diese Methode überschreiben, erwartet, dass sie höchstens zwei Parameter akzeptieren, die locales
und options
entsprechen, wie etwa Number.prototype.toLocaleString
. Die Parameterpositionen sollten nicht für andere Zwecke verwendet werden.
Rückgabewert
Der Rückgabewert des Aufrufs von this.toString()
.
Beschreibung
Alle Objekte, die von Object.prototype
erben (also alle außer Objekten mit null
-Prototyp), erben die toLocaleString()
-Methode. toLocaleString
von Object
gibt das Ergebnis des Aufrufs von this.toString()
zurück.
Diese Funktion wird bereitgestellt, um Objekten eine generische toLocaleString
-Methode zu geben, auch wenn nicht alle diese nutzen. In der Kernauszeichnung überschreiben folgende eingebaute Objekte toLocaleString
, um eine lokalisierungsspezifische Formatierung zu bieten:
Beispiele
Verwendung der Basis-methode toLocaleString()
Die Basis toLocaleString()
-Methode ruft einfach toString()
auf.
const obj = {
toString() {
return "My Object";
},
};
console.log(obj.toLocaleString()); // "My Object"
Überschreibung von Array toLocaleString()
Array.prototype.toLocaleString()
wird verwendet, um Array-Werte als Zeichenkette zu drucken, 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 €"
Überschreibung von Date toLocaleString()
Date.prototype.toLocaleString()
wird verwendet, um Datumsausgaben zu drucken, die für bestimmte Lokale 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"
Überschreibung von Number toLocaleString()
Number.prototype.toLocaleString()
wird verwendet, um Zahlenausgaben zu drucken, die für bestimmte Lokale besser geeignet sind, z. B. mit den richtigen 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
BCD tables only load in the browser