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 einen String zurück, der dieses Objekt repräsentiert. Diese Methode soll von abgeleiteten Objekten für länderspezifische 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. Alle Objekte, die diese Methode überschreiben, sollten jedoch höchstens zwei Parameter akzeptieren, die locales
und options
entsprechen, wie z. B. 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 (das heißt alle außer null
-Prototyp-Objekten), 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 eine länderspezifische Formatierung zu bieten:
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 String auszugeben, indem die toLocaleString()
Methode jedes Elements aufgerufen und die Ergebnisse mit einem länderspezifischen 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 Datumsangaben auszugeben, die besser für bestimmte Länder 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 Zahlenanzeigen auszugeben, die besser für bestimmte Länder 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 |