CKTIS / JavaScript
Date.parse: Datumstext zum Zeitstempel
Date.parse wandelt Datumstext in Epochenmillisekunden um oder liefert NaN, wenn der Text unbekannt oder außerhalb des Bereichs ist.
Version: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2
Syntax
Date.parse(dateString)Date.parse(string) wandelt das Argument zuerst in Text um und liefert dann einen Zeitwert in Millisekunden seit der Epoche. Das standardisierte date-time-Format ist eine ISO-8601-Form wie 2024-02-29T12:30:00+02:00. Nur ein Datum wie 2024-02-29 wird als UTC interpretiert; Datum und Uhrzeit ohne Offset werden in der lokalen Zeitzone interpretiert.
Ungültiger Text oder ein Wert außerhalb des TimeClip-Bereichs ±8.64e15 ergibt NaN, keine Ausnahme. Die Textumwandlung des Arguments kann dennoch auslösen, etwa bei einem Symbol. Das Format von toISOString() muss akzeptiert werden; für Daten ohne Millisekunden sind auch die Formate von toString() und toUTCString() vorgeschrieben. Andere Formate sind implementierungsabhängig.
Für Datenaustausch sollte die vollständige ISO-Form mit Z oder explizitem Offset statt mehrdeutiger lokaler Schreibweise verwendet werden. Date.parse existiert seit der ersten ECMAScript-Ausgabe; Regeln für offsetfreie Daten wurden später präzisiert.
Beispiele
const dateOnly = Date.parse("2024-02-29");
const withOffset = Date.parse("2024-02-29T12:30:00+02:00");
console.log(dateOnly, new Date(dateOnly).toISOString());
console.log(withOffset, new Date(withOffset).toISOString());
console.log(Number.isNaN(Date.parse("not a date")));Ergebnis
1709164800000 2024-02-29T00:00:00.000Z 1709202600000 2024-02-29T10:30:00.000Z true