Date.parse()

dateString

Eine Zeichenkette im Date-Time-String-Format. Sehen Sie sich die verlinkte Referenz für Vorsichtsmaßnahmen bei der Verwendung verschiedener Formate an.

Eine Zahl, die den Zeitstempel des angegebenen 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 Zeichenkettenwerten festzulegen, beispielsweise in Verbindung mit der setTime() Methode.

Die Formate, die parse() verarbeiten kann, sind nicht ausdrücklich festgelegt, aber es gibt einige Invarianten:

• Das Date-Time-String-Format (erstellt durch toISOString()) muss unterstützt werden.
• Wenn x ein beliebiges Datum ist, dessen Millisekundenwert null ist, dann sollte x.valueOf() gleich einem der folgenden sein: Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Das bedeutet, dass die Formate, die durch toString() und toUTCString() erstellt werden, ebenfalls unterstützt werden sollten.
• Die Spezifikation erfordert nicht die Unterstützung des Formats, das durch toLocaleString() erstellt wird. Allerdings versuchen alle großen Engines, das toLocaleString("en-US") Format zu unterstützen.

Andere Formate sind implementierungsdefiniert und funktionieren möglicherweise nicht in allen Browsern. Eine Bibliothek kann hilfreich sein, wenn viele verschiedene Formate unterstützt werden müssen. Tatsächlich ist die Unzuverlässigkeit von Date.parse() eine der Beweggründe für die Einführung der Temporal API.

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

Die folgenden Aufrufe geben alle 1546300800000 zurück. Der erste impliziert die UTC-Zeit, weil er nur das Datum enthält, und die anderen geben die UTC-Zeitzone ausdrücklich 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 Zeit enthält.

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

Abgesehen vom Standard-Date-Time-String-Format 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

Implementierungen verwenden in der Regel die lokale Zeitzone, wenn die Datumszeichenkette nicht standardisiert ist. Zur Konsistenz nehmen wir an, dass die Laufzeit die UTC-Zeitzone verwendet, und es sei denn, es wird anders angegeben, kann sich die Ausgabe mit der Zeitzone des Geräts ändern. 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 großzügig beim Parsen von Datumszeichenketten und können jeden Teil einer Zeichenkette weglassen, den sie nicht analysieren können. Aus Kompatibilitätsgründen kopieren Browser oft das Verhalten voneinander, sodass sich diese Verarbeitungspatterns über mehrere Browser hinweg verbreiten. Wie bereits erwähnt, sind die folgenden Beispiele nur zur Illustration gedacht und keineswegs vollständig:

• Date.UTC()