Date.parse()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die statische Methode Date.parse() analysiert die Zeichenkettendarstellung eines Datums und gibt dessen Zeitstempel zurück.
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 Uhrzeitformat. Hinweise zur Verwendung anderer Formate finden Sie in der verlinkten Referenz.
Rückgabewert
Eine Zahl, die den Zeitstempel des angegebenen Datums darstellt. Wenn dateString nicht als gültiges Datum analysiert werden kann, wird NaN zurückgegeben.
Beschreibung
Diese Funktion ist nützlich, um Datumswerte anhand von Zeichenketten festzulegen, beispielsweise in Verbindung mit der Methode setTime().
Die Formate, die parse() verarbeiten kann, sind nicht ausdrücklich festgelegt. Es gibt jedoch einige Invarianten:
- Das Datums- und Uhrzeitformat, das von
toISOString()erzeugt wird, muss unterstützt werden. - Wenn
xein Date ist, dessen Millisekundenanteil null beträgt, solltex.valueOf()jedem der folgenden Werte entsprechen:Date.parse(x.toString()),Date.parse(x.toUTCString()),Date.parse(x.toISOString()). Das bedeutet, dass auch die vontoString()undtoUTCString()erzeugten Formate unterstützt werden sollten. - Die Spezifikation verlangt keine Unterstützung für das von
toLocaleString()erzeugte Format. Die großen JavaScript-Engines versuchen jedoch alle, das Format vontoLocaleString("en-US")zu unterstützen.
Andere Formate hängen von der Implementierung ab und funktionieren möglicherweise nicht in allen Browsern. Wenn viele unterschiedliche Formate verarbeitet werden müssen, kann eine Bibliothek helfen. Die Unzuverlässigkeit von Date.parse() ist einer der Grü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 von Ihnen erstellten Date-Objekts.
Beispiele
>Date.parse() verwenden
Die folgenden Aufrufe geben alle 1546300800000 zurück. Beim ersten wird UTC angenommen, da nur ein Datum angegeben ist. 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");
Beim folgenden Aufruf, der keine Zeitzone angibt, wird das Datum auf den 01.01.2019 um 00:00:00 Uhr in der lokalen Zeitzone des Systems gesetzt, da sowohl ein Datum als auch eine Uhrzeit angegeben sind.
Date.parse("2019-01-01T00:00:00");
Formate von toString() und toUTCString()
Neben dem standardisierten Datums- und Uhrzeitformat werden auch die Formate von 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
Nicht standardisierte Datumszeichenketten
Hinweis: Dieser Abschnitt beschreibt implementierungsspezifisches Verhalten, das sich zwischen Browsern oder verschiedenen Browserversionen unterscheiden kann. Er ist keine vollständige Tabelle zur Browser-Kompatibilität. Testen Sie daher jedes Format selbst, bevor Sie es in Ihrem Code verwenden.
Bei nicht standardisierten Datumszeichenketten verwenden Implementierungen normalerweise standardmäßig die lokale Zeitzone. Für die folgenden Beispiele nehmen wir an, dass die Laufzeitumgebung die UTC-Zeitzone verwendet. Sofern nicht anders angegeben, hängt die Ausgabe von der Zeitzone des Geräts ab. Auch die Sommerzeit (DST) in der lokalen Zeitzone kann sich darauf auswirken.
Hier sind weitere Beispiele für nicht standardisierte Datumszeichenketten. Browser sind beim Analysieren von Datumszeichenketten sehr tolerant und können Teile einer Zeichenkette verwerfen, die sie nicht analysieren können. Aus Kompatibilitätsgründen übernehmen Browser häufig das Verhalten anderer Browser, sodass sich solche Verarbeitungsmuster browserübergreifend verbreiten. Wie bereits erwähnt, dienen die folgenden Beispiele nur zur Veranschaulichung und sind keineswegs vollständig:
| Beschreibung | Beispiel | Chrome | Firefox | Safari |
|---|---|---|---|---|
| Einzelne Zahl | 0 (einstellig) |
946684800000 (01. Jan. 2000); NaN in Firefox ≤122 | -62167219200000 (01. Jan. 0000) | |
31 (zweistellig) |
NaN | -61188912000000 (01. Jan. 0031) | ||
999 (drei- oder vierstellig) |
-30641760000000 (01. Jan. 0999) | |||
| Datumszeichenketten mit unterschiedlichen Trennzeichen | 1970-01-01 (standardisiert) |
0 in allen Zeitzonen | ||
1970/01/01 |
0 | |||
1970,01,01 |
0 | NaN | ||
1970 01 01 |
0 | NaN | ||
Zeichenketten, die wie die Ausgabe von toString() aussehen |
Thu Jan 01 1970 00:00:00Thu Jan 01 1970Jan 01 1970 00:00:00Jan 01 1970 |
0 | ||
Zeichenketten, die wie die Ausgabe von toUTCString() aussehen |
Thu, 01 Jan 1970 00:00:00Thu, 01 Jan 197001 Jan 1970 00:00:0001 Jan 1970 |
0 | ||
| Erster Datumsbestandteil ist zweistellig | 01-02-03 (der erste Teil kann ein gültiger Monat sein) |
1041465600000 (02. Jan. 2003) | -62132745600000 (03. Feb. 0001) Hinweis: Safari nimmt immer das Format YY-MM-DD an, nicht aber MM/DD/YY. |
|
27-02-03 (der erste Teil kann ein gültiger Tag, aber kein gültiger Monat sein) |
NaN | -61312291200000 (03. Feb. 0027) | ||
49-02-03 (der erste Teil kann kein gültiger Tag sein und ist <50) |
2495923200000 (03. Feb. 2049) | -60617980800000 (03. Feb. 0049) | ||
50-02-03 (der erste Teil kann kein gültiger Tag sein und ist ≥50) |
-628300800000 (03. Feb. 1950) | -60586444800000 (03. Feb. 0050) | ||
| Datumsbestandteile außerhalb des gültigen Bereichs | 2014-25-23Mar 32, 20142014/25/23 |
NaN | ||
2014-02-30 |
1393718400000 (02. März 2014) | NaN | ||
02/30/2014 |
1393718400000 | |||
| Zusätzliche Zeichen nach dem Monatsnamen | 04 Dec 199504 Decem 199504 December 1995 |
818035200000 | ||
04 DecFoo 1995 |
818035200000 Nur die ersten drei Zeichen werden gelesen. Firefox ≤121 liest bis zum Ende des gültigen Monatsnamens und gibt daher NaN zurück, wenn es auf „F“ stößt. |
|||
04 De 1995 |
NaN | |||
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.parse> |