Date.parse()

dateString

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

Eine Zahl, die den Zeitstempel des angegebenen Datums darstellt. Wenn dateString nicht als gültiges Datum geparst werden kann, wird NaN zurückgegeben.

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

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

• Das Datums-Zeit-Format (erzeugt durch toISOString()) muss unterstützt werden.
• Wenn x ein beliebiges Datum ist, dessen Millisekunden null sind, sollte x.valueOf() gleich einem der folgenden Ausdrücke 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 keine Unterstützung für das durch toLocaleString() erzeugte Format. Allerdings versuchen alle großen Engines, das Format toLocaleString("en-US") zu unterstützen.

Andere Formate sind implementierungsabhängig und funktionieren möglicherweise nicht in allen Browsern. Eine Bibliothek kann hilfreich sein, wenn viele verschiedene Formate unterstützt werden sollen. Tatsächlich ist die Unzuverlässigkeit von Date.parse() einer der Gründe 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 Anrufe geben alle 1546300800000 zurück. Der erste impliziert UTC-Zeit, da er nur das Datum enthält, und die anderen geben explizit die UTC-Zeitzone 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 Anruf, der keine Zeitzone angibt, wird auf den 2019-01-01 um 00:00:00 in der lokalen Zeitzone des Systems gesetzt, da er sowohl Datum als auch Zeit enthält.

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

Abgesehen vom standardisierten Datums-Zeit-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 normalerweise die lokale Zeitzone, wenn die Datums-Zeichenkette nicht standardisiert ist. Zur Konsistenz gehen wir davon aus, dass der Ablauf die UTC-Zeitzone verwendet. Sofern nicht anders angegeben, variiert die Ausgabe mit der Zeitzone des Geräts. Die Sommerzeit (DST) der lokalen Zeitzone kann ebenfalls einen Einfluss haben.

Hier sind einige weitere Beispiele für nicht standardisierte Datums-Zeichenketten. Browser sind beim Parsen von Datums-Zeichenketten sehr tolerant und können Teile einer Zeichenkette, die sie nicht analysieren können, verwerfen. Aus Kompatibilitätsgründen kopieren Browser oft das Verhalten anderer, sodass sich diese Verhaltensmuster von Browser zu Browser verbreiten. Wie bereits erwähnt, dienen die folgenden Beispiele nur zur Veranschaulichung und sind keineswegs vollständig:

• Date.UTC()