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

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

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

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

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"

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

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toLocaleString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch