Date.parse()

Probieren Sie es aus

// Standard date-time string format
const unixTimeZero = Date.parse("1970-01-01T00:00:00Z");
// Non-standard format resembling toUTCString()
const javaScriptRelease = Date.parse("04 Dec 1995 00:12:00 GMT");

console.log(unixTimeZero);
// Expected output: 0

console.log(javaScriptRelease);
// Expected output: 818035920000

Syntax

Date.parse(dateString)

Parameter

dateString

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

Rckgabewert

Eine Zahl, die den Zeitstempel des angegebenen Datums darstellt. Wenn dateString nicht als gltiges Datum geparst werden kann, wird NaN zurckgegeben.

Beschreibung

Diese Funktion ist ntzlich, 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 untersttzt 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 untersttzt werden sollten.
• Die Spezifikation erfordert nicht die Untersttzung des Formats, das durch toLocaleString() erzeugt wird. Groe Engines versuchen jedoch alle, das toLocaleString("en-US") Format zu untersttzen.

Andere Formate sind implementationsspezifisch und funktionieren mglicherweise nicht in allen Browsern. Eine Bibliothek kann helfen, wenn viele unterschiedliche Formate untersttzt werden mssen. Tatschlich ist die Unzuverlssigkeit von Date.parse() eines der Motive fr die Einfhrung 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.

Beispiele

Verwendung von Date.parse()

Die folgenden Aufrufe geben alle 1546300800000 zurck. 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 enthlt.

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

toString() und toUTCString() Formate

Neben dem Standard-Datums- und Zeitformat werden die Formate toString() und toUTCString() untersttzt:

// 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

Nicht-standardisierte Datumszeichenketten

Implementationen standardmig setzen hufig die lokale Zeitzone, wenn die Datumszeichenkette nicht standardisiert ist. Fr Konsistenz nehmen wir an, dass die Laufzeit die UTC-Zeitzone verwendet, und sofern nicht anders angegeben, variiert die Ausgabe mit der Zeitzone des Gerts. Die Sommerzeit (DST) der lokalen Zeitzone kann ebenfalls einen Einfluss darauf haben.

Hier sind einige weitere Beispiele fr nicht-standardisierte Datumszeichenketten. Browser sind sehr nachsichtig beim Parsen von Datumszeichenketten und knnen Teile einer Zeichenkette, die sie nicht parsen knnen, ignorieren. Aus Kompatibilittsgrnden kopieren Browser hufig das Verhalten anderer, sodass sich diese Verarbeitungsmuster ber Browser hinweg verbreiten. Wie bereits erwhnt, dienen die folgenden Beispiele nur zur Veranschaulichung und sind keineswegs erschpfend:

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Date.UTC()