Object.prototype.toLocaleString() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Object.prototype.toLocaleString()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die toLocaleString() Methode von Object Instanzen gibt einen String zurück, der dieses Objekt repräsentiert. Diese Methode soll von abgeleiteten Objekten für lokal-spezifische Zwecke überschrieben werden.

In diesem Artikel

Probieren Sie es aus

const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));

console.log(date.toLocaleString("ar-EG"));
// Expected output: "٢٠‏/١٢‏/٢٠١٢ ٤:٠٠:٠٠ ص"

const number = 123456.789;

console.log(number.toLocaleString("de-DE"));
// Expected output: "123.456,789"

Syntax

toLocaleString()

Parameter

Keine. Es wird jedoch erwartet, dass alle Objekte, die diese Methode überschreiben, maximal 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. Object's toLocaleString gibt das Ergebnis des Aufrufs von this.toString() zurück.

Diese Funktion wird bereitgestellt, um Objekten eine generische toLocaleString Methode zu geben, obwohl nicht alle sie nutzen mögen. In der Kernsprache überschreiben diese eingebauten Objekte toLocaleString, um lokal-spezifische Formatierungen 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"

Überschreibung von Array toLocaleString()

Array.prototype.toLocaleString() wird verwendet, um Array-Werte als String auszugeben, indem die toLocaleString() Methode jedes Elements aufgerufen wird und die Ergebnisse mit einem lokal-spezifischen 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 Datumsanzeigen auszugeben, die für spezifische 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 Zahldarstellungen auszugeben, die für spezifische 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"

Object.prototype.toString()

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Object
Konstruktor
1. Object()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor