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 July 2015.
Die toLocaleString()
-Methode von Object
-Instanzen gibt eine Zeichenkette zurück, die dieses Objekt darstellt. Diese Methode ist dazu bestimmt, 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 wird erwartet, dass alle Objekte, die diese Methode überschreiben, höchstens zwei Parameter akzeptieren, die locales
und options
entsprechen, wie zum Beispiel 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 ‘null’-Prototyp-Objekte), erben die toLocaleString()
-Methode. Die toLocaleString
-Methode 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 sie nutzen. Im Kern der Sprache überschreiben diese eingebauten Objekte toLocaleString
, um lokalisierungsspezifische Formatierungen 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"
Array toLocaleString()-Überschreibung
Array.prototype.toLocaleString()
wird verwendet, um Array-Werte als Zeichenfolge auszugeben, indem die toLocaleString()
-Methode jedes Elements aufgerufen und die Ergebnisse mit einem lokalisierungsspezifischen Separator verbunden werden. Zum Beispiel:
const testArray = [4, 7, 10];
const euroPrices = testArray.toLocaleString("fr", {
style: "currency",
currency: "EUR",
});
// "4,00 €,7,00 €,10,00 €"
Date toLocaleString()-Überschreibung
Date.prototype.toLocaleString()
wird verwendet, um Datumsanzeigen auszugeben, die für spezifische 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"
Number toLocaleString()-Überschreibung
Number.prototype.toLocaleString()
wird verwendet, um Zahlanzeigen auszugeben, die für spezifische Lokalisierungen 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® 2026 Language Specification # sec-object.prototype.tolocalestring |