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

js
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.

js
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:

js
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:

js
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:

js
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

Siehe auch