Date.prototype.toLocaleDateString()

Syntax

dateObj.toLocaleDateString([locales [, options]])

Parameter

Überprüfe das Kapitel Browserkompatibilität, um zu erfahren, welcher Browser die Argumente locales and options unterstützt. Zudem sollte das Beispiel Unterstützung der Argumente locales und options beachtet werden.

Der Standardwert für jede Eigenschaft einer Datums-Zeitkomponente ist undefined, wenn aber die Eigenschaften weekday, year, month, day undefined sind, sind die Eigenschaften year, month, und day "numeric".

Rückgabewert

Einen String, der den Datumsteil des gegebenen Date Objektes mit sprachspezifischen Konventionen repräsentiert.

Beispiele

Einsatz von toLocaleDateString()

Standardeinsatz ohne Angaben zur Sprache und Formatierung. Ein formatierter String in der Standardsprache mit Standardoption wird zurückgegeben.

var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0));

// toLocaleDateString() ohne Argumente abhängig von der Implementierung,
// der Standardsprache und der Standardzeitzone.
console.log(date.toLocaleDateString());
// → "12/11/2012" wenn in der Sprache en-US mit America/Los_Angeles Zeitzone ausgeführt

Unterstützung der Argumente locales und options

Die Argumente locales and options sind noch nicht in allen Browsern unterstützt. Um herauszufinden, ob eine Implementierung die Argumente unterstützt, kann die Anforderung benutzt werden, dass bei nicht existierenden Sprachen ein RangeError erzeugt wird:

function toLocaleDateStringSupportsLocales() {
  try {
    new Date().toLocaleDateString('i');
  } catch (e) {
    return e.name === 'RangeError';
  }
  return false;
}

Einsatz von locales

Das Beispiel zeigt einige Variation von internationalisierten Datumsformaten. Um das Format der Sprache der Benutzerschnittstelle (z. B. Webseite) zu bekommen, muss die Sprache (und manchmal eine fallback Sprache) mit dem Argument locales gesetzt werden:

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

// US Englischer Einsatz von Monat-Tag-Jahr
console.log(date.toLocaleDateString('en-US'));
// → "12/19/2012"

// British Englischer Einsatz von Tag-Monat-Jahr
console.log(date.toLocaleDateString('en-GB'));
// → "20/12/2012"

// Koreanischer Einsatz von Jahr-Monat-Tag
console.log(date.toLocaleDateString('ko-KR'));
// → "2012. 12. 20."

// In den meisten arabischen Ländern werden arabische Ziffern genutzt.
console.log(date.toLocaleDateString('ar-EG'));
// → "٢٠‏/١٢‏/٢٠١٢"

// Für mansche japanische Anwendungen wird er japanische Kalender benutzt,
// bei dem das Jahr 2012 das Jahr 24 der Heisei-Zeit ist.
console.log(date.toLocaleDateString('ja-JP-u-ca-japanese'));
// → "24/12/20"

// Wenn eine Sprache angegeben wird, die vielleicht nicht unterstützt wird,
// wie Balinesisch, wird eine fallback Sprache (Indonesisch) definiert.
console.log(date.toLocaleDateString(['ban', 'id']));
// → "20/12/2012"

Einsatz von options

Das Ergebnis der toLocaleDateString() Methode kann benutzerdefiniert mit dem Argument options beeinflusst werden.

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

// Gibt einen Wochentag und ein langes Datum zurück.
var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
console.log(date.toLocaleDateString('de-DE', options));
// → "Donnerstag, 20. Dezember 2012"

// Macht UTC sichtbar
options.timeZone = 'UTC';
options.timeZoneName = 'short';
console.log(date.toLocaleDateString('en-US', options));
// → "Thursday, December 20, 2012, GMT"

Performance

Wenn viele Daten formatiert werden sollen, ist es besser ein Intl.DateTimeFormat Objekt zu erstellen und die Funktion format zu benutzen.

Spezifikationen

Browserkompatibilität

[1] Chrome 24 hat eine Unterstützung für andere Zeitzonen außer der UTC hinzugefügt.

[2] Siehe WebKit bug.

Siehe auch

• Intl.DateTimeFormat
• Date.prototype.toLocaleString()
• Date.prototype.toLocaleTimeString()
• Date.prototype.toString()