Date.parse()

dateString

Ein String im Datums-Zeit-String-Format. Siehe die verlinkte Referenz für Hinweise zur Verwendung verschiedener Formate.

Eine Zahl, die den Timestamp des gegebenen Datums darstellt. Wenn dateString nicht als gültiges Datum analysiert werden kann, wird NaN zurückgegeben.

Diese Funktion ist nützlich, um Datumswerte basierend auf String-Werten festzulegen, zum Beispiel in Verbindung mit der setTime()-Methode.

Die Formate, die parse() verarbeiten kann, sind nicht explizit spezifiziert, aber es gibt einige Invariantien:

• Das Datums-Zeit-String-Format (erzeugt durch toISOString()) muss unterstützt werden.
• Wenn x ein beliebiges Datum ist, dessen Millisekundenbetrag null ist, sollte x.valueOf() gleich einem der folgenden sein: Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Das bedeutet, die durch toString() und toUTCString() erzeugten Formate sollten ebenfalls unterstützt werden.
• Die Spezifikation erfordert nicht die Unterstützung für das durch toLocaleString() erzeugte Format. Große Engines versuchen jedoch, das toLocaleString("en-US")-Format zu unterstützen.

Andere Formate sind implementationsspezifisch und funktionieren möglicherweise nicht in allen Browsern. Eine Bibliothek kann helfen, wenn viele verschiedene Formate berücksichtigt werden müssen. Tatsächlich ist die Unzuverlässigkeit von Date.parse() eine der Motivationen für die Einführung der Temporal-API.

Da parse() eine statische Methode von Date ist, wird sie immer als Date.parse() verwendet, nicht als Methode eines von Ihnen erstellten Date-Objekts.

Die folgenden Aufrufe geben alle 1546300800000 zurück. Der erste impliziert UTC-Zeit, da er nur das Datum enthält, und die anderen geben die UTC-Zeitzone explizit an.

Date.parse("2019-01-01");
Date.parse("2019-01-01T00:00:00.000Z");
Date.parse("2019-01-01T00:00:00.000+00:00");

Der folgende Aufruf, der keine Zeitzone angibt, wird auf den 01.01.2019 um 00:00:00 in der lokalen Zeitzone des Systems gesetzt, da er sowohl Datum als auch Uhrzeit enthält.

Date.parse("2019-01-01T00:00:00");

Neben dem standardmäßigen Datums-Zeit-String-Format werden die toString()- und toUTCString()-Formate unterstützt:

// toString() format
Date.parse("Thu Jan 01 1970 00:00:00 GMT-0500 (Eastern Standard Time)");
// 18000000 in all implementations in all timezones

// toUTCString() format
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");
// 0 in all implementations in all timezones

Implementierungen verwenden in der Regel die lokale Zeitzone, wenn der Datums-String nicht standardmäßig ist. Zur Konsistenz nehmen wir an, dass die Laufzeit die UTC-Zeitzone verwendet, und sofern nicht anders angegeben, variiert die Ausgabe mit der Zeitzone des Geräts. Die Sommerzeit (DST) der lokalen Zeitzone kann ebenfalls Auswirkungen darauf haben.

Hier sind einige weitere Beispiele für nicht standardmäßige Datums-Strings. Browser sind beim Parsen von Datum-Strings sehr tolerant und ignorieren möglicherweise Teile eines Strings, die sie nicht analysieren können. Aus Kompatibilitätsgründen kopieren Browser oft das Verhalten voneinander, sodass sich diese Umgangsmuster browserübergreifend verbreiten. Wie bereits erwähnt, dienen die folgenden Beispiele nur der Veranschaulichung und sind keineswegs erschöpfend:

• Date.UTC()