JavaScript/Objekte/Date/parse

Die Methode Date.parse() ermittelt aus einer als Parameter zu übergebenden Zeichenkette die Anzahl Millisekunden, die zwischen dem 01.01.1970, 0:00:00 Uhr UTC, und dem übergebenen Zeitpunkt verstrichen sind.

Syntax

Date.parse(zeichenkette)

Es handelt sich um eine Methode des globalen Date-Objekts, und nicht um eine Methode von Date.prototype.

Parameter:

zeichenkette

Eine Datums- und Zeitangabe im Format von ISO8601. Bei Angaben, die nicht in diesem Format sind, kann der Browser eine Interpretation versuchen, scheitert in Deutschland aber zumeist daran, dass "01.03.2024" als dritter Januar und nicht als erster März interpretiert wird.

Rückgabewert ist

• eine ganze Zahl, die die vergangenen Millisekunden seit dem 1. Januar 1970 00:00:00 UTC angibt.
• NaN, wenn die Zeichenkette kein Datum ist oder ungültige Werte hat (31.02.2017)

Empfehlung: Da Zeichenketten mit Zeitangaben in verschiedenen Formatierungen existieren können, ist ein manuelles Einlesen und Validieren stets vorzuziehen.
→ JavaScript/Tutorials/Validierung von Zeitangaben

Anwendungsbeispiel

Beispiel

const dreißigJahre = Date.parse("2000-01-01");
console.log(dreißigJahre);

Das Beispiel ermittelt die Anzahl Millisekunden zwischen dem Unix-Epochenbeginn (01.01.1970 Mitternacht UTC) und dem 01.01.2000. Das Ergebnis wird in der Variablen DreissigJahre gespeichert. Zur Kontrolle wird die Zahl in der Konsole ausgegeben.

Weblinks

• ECMAScript Spezifikation: Date.parse()
• MDN: Date.parse() bei Mozilla