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
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()
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> |