Date.prototype.toDateString()
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 toDateString() von Date-Instanzen gibt einen String zurück, der den Datumsanteil des Datums in der lokalen Zeitzone darstellt.
Probieren Sie es aus
const event = new Date(1993, 6, 28, 14, 39, 7);
console.log(event.toString());
// Expected output: "Wed Jul 28 1993 14:39:07 GMT+0200 (CEST)"
// Note: your timezone may vary
console.log(event.toDateString());
// Expected output: "Wed Jul 28 1993"
Syntax
toDateString()
Parameter
Keine.
Rückgabewert
Ein String, der den Datumsanteil des angegebenen Datums darstellt (zum Format siehe Beschreibung). Ist das Datum ungültig, wird "Invalid Date" zurückgegeben.
Beschreibung
Date-Instanzen beziehen sich auf einen bestimmten Zeitpunkt. toDateString() interpretiert das Datum in der lokalen Zeitzone und formatiert den Datumsanteil auf Englisch. Dabei wird immer das folgende Format verwendet, dessen Bestandteile durch Leerzeichen getrennt sind:
- Die ersten drei Buchstaben des Wochentagsnamens
- Die ersten drei Buchstaben des Monatsnamens
- Zweistelliger Tag des Monats, bei Bedarf links mit einer Null aufgefüllt
- Mindestens vierstellige Jahreszahl, bei Bedarf links mit Nullen aufgefüllt. Kann ein Minuszeichen haben
Zum Beispiel: „Thu Jan 01 1970“.
- Wenn Sie nur den Uhrzeitanteil erhalten möchten, verwenden Sie
toTimeString(). - Wenn Sie sowohl das Datum als auch die Uhrzeit erhalten möchten, verwenden Sie
toString(). - Wenn das Datum statt in der lokalen Zeitzone als UTC interpretiert werden soll, verwenden Sie
toUTCString(). - Wenn Sie das Datum in einem benutzerfreundlicheren Format ausgeben möchten (z. B. lokalisiert), verwenden Sie
toLocaleDateString().
Beispiele
>toDateString() verwenden
const d = new Date(0);
console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"
console.log(d.toDateString()); // "Thu Jan 01 1970"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.todatestring> |