Date.parse()

dateString

Eine Zeichenkette im Datums- und Zeitformat. Weitere Informationen zu den Fallstricken bei der Verwendung unterschiedlicher Formate finden Sie in der verlinkten Referenz.

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 Zeichenkettenwerten festzulegen, zum Beispiel in Verbindung mit der setTime() Methode.

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

• Das Datums- und Zeitformat (produziert von toISOString()) muss unterstützt werden.
• Wenn x ein Date ist, dessen Millisekundenmenge null ist, dann sollte x.valueOf() gleich einem der folgenden sein: Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Dies bedeutet, dass die Formate, die durch toString() und toUTCString() produziert werden, ebenfalls unterstützt werden sollten.
• Die Spezifikation erfordert nicht die Unterstützung des Formats, das durch toLocaleString() erzeugt wird. Große Engines versuchen jedoch alle, 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 unterschiedliche Formate unterstützt werden müssen. Tatsächlich ist die Unzuverlässigkeit von Date.parse() eines der Motive für die Einführung der Temporal API.

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

Die folgenden Aufrufe geben alle 1546300800000 zurück. Der erste impliziert UTC-Zeit, da es sich nur um ein Datum handelt, und die anderen spezifizieren explizit die UTC-Zeitzone.

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 2019-01-01 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 Standard-Datums- und Zeitformat werden die Formate toString() und toUTCString() 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

Implementationen standardmäßig setzen häufig die lokale Zeitzone, wenn die Datumszeichenkette nicht standardisiert ist. Für 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 einen Einfluss darauf haben.

Hier sind einige weitere Beispiele für nicht-standardisierte Datumszeichenketten. Browser sind sehr nachsichtig beim Parsen von Datumszeichenketten und können Teile einer Zeichenkette, die sie nicht parsen können, ignorieren. Aus Kompatibilitätsgründen kopieren Browser häufig das Verhalten anderer, sodass sich diese Verarbeitungsmuster über Browser hinweg verbreiten. Wie bereits erwähnt, dienen die folgenden Beispiele nur zur Veranschaulichung und sind keineswegs erschöpfend:

• Date.UTC()