WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen