Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Date.prototype.toString()

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 Methode toString() von Date-Instanzen gibt einen String zurück, der dieses Datum in der lokalen Zeitzone darstellt.

Probieren Sie es aus

const event = new Date("August 19, 1975 23:15:30");

console.log(event.toString());
// Expected output: "Tue Aug 19 1975 23:15:30 GMT+0200 (CEST)"
// Note: your timezone may vary

Syntax

js
toString()

Parameter

Keine.

Rückgabewert

Ein String, der das angegebene Datum darstellt (siehe Beschreibung für das Format). Gibt "Invalid Date" zurück, wenn das Datum ungültig ist.

Beschreibung

Die Methode toString() ist Teil des Protokolls zur Typumwandlung. Da Date über eine Methode [Symbol.toPrimitive]() verfügt, hat diese immer Vorrang vor toString(), wenn ein Date-Objekt implizit in einen String umgewandelt wird. Allerdings ruft Date.prototype[Symbol.toPrimitive]() intern weiterhin this.toString() auf.

Das Objekt Date überschreibt die Methode toString() von Object. Date.prototype.toString() gibt eine String-Darstellung des Datums in der lokalen Zeitzone zurück, die sowohl das Datum als auch die Uhrzeit enthält. Dazu werden die von toDateString() und toTimeString() erzeugten String-Darstellungen mit einem Leerzeichen dazwischen verbunden. Zum Beispiel: „Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)“.

Date.prototype.toString() muss für eine Date-Instanz aufgerufen werden. Wenn der this-Wert keine Instanz von Date ist, wird ein TypeError ausgelöst.

  • Wenn Sie nur das Datum benötigen, verwenden Sie toDateString().
  • Wenn Sie nur die Uhrzeit benötigen, verwenden Sie toTimeString().
  • Wenn das Datum in UTC statt in der lokalen Zeitzone interpretiert werden soll, verwenden Sie toUTCString().
  • Wenn Sie das Datum in einem benutzerfreundlicheren Format darstellen möchten (z. B. entsprechend einer Sprache oder Region), verwenden Sie toLocaleString().

Beispiele

Verwendung von toString()

js
const d = new Date(0);
console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-date.prototype.tostring

Browser-Kompatibilität

Siehe auch