Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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 x ein Date ist, dessen Millisekundenanteil null beträgt, sollte x.valueOf() jedem der folgenden Werte entsprechen: Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Das bedeutet, dass auch die von toString() und toUTCString() 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 von toLocaleString("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.

js
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.

js
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:

js
// 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:00
Thu Jan 01 1970
Jan 01 1970 00:00:00
Jan 01 1970
0
Zeichenketten, die wie die Ausgabe von toUTCString() aussehen Thu, 01 Jan 1970 00:00:00
Thu, 01 Jan 1970
01 Jan 1970 00:00:00
01 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-23
Mar 32, 2014
2014/25/23
NaN
2014-02-30 1393718400000 (02. März 2014) NaN
02/30/2014 1393718400000
Zusätzliche Zeichen nach dem Monatsnamen 04 Dec 1995
04 Decem 1995
04 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

Browser-Kompatibilität

Siehe auch