Date()-Konstruktor

new Date()
new Date(value)
new Date(dateString)
new Date(dateObject)

new Date(year, monthIndex)
new Date(year, monthIndex, day)
new Date(year, monthIndex, day, hours)
new Date(year, monthIndex, day, hours, minutes)
new Date(year, monthIndex, day, hours, minutes, seconds)
new Date(year, monthIndex, day, hours, minutes, seconds, milliseconds)

Date()

Note: Date() kann mit oder ohne new aufgerufen werden, jedoch mit unterschiedlichen Effekten. Siehe Rückgabewert.

Es gibt fünf grundlegende Formen für den Date()-Konstruktor:

Keine Parameter

Wenn keine Parameter angegeben werden, repräsentiert das neu erstellte Date-Objekt das aktuelle Datum und die aktuelle Uhrzeit zum Zeitpunkt der Instanziierung. Der Zeitstempel des zurückgegebenen Datums ist derselbe wie die Zahl, die durch Date.now() zurückgegeben wird.

Zeitwert oder Zeitstempel-Zahl

value

Ein ganzzahliger Wert, der den Zeitstempel darstellt (die Anzahl der Millisekunden seit Mitternacht zu Beginn des 1. Januar 1970, UTC — auch bekannt als Epoche).

Datum-Zeichenkette

dateString

Ein Zeichenkettenwert, der ein Datum darstellt, analysiert und interpretiert mit demselben Algorithmus, der durch Date.parse() implementiert wird. Siehe Datums- und Uhrzeitformat für Hinweise zur Verwendung verschiedener Formate.

Date-Objekt

dateObject

Ein bestehendes Date-Objekt. Dies ist im Grunde eine Kopie des bestehenden Date-Objekts mit demselben Datum und derselben Uhrzeit. Dies ist gleichbedeutend mit new Date(dateObject.valueOf()), außer dass die valueOf()-Methode nicht aufgerufen wird.

Wenn ein Parameter an den Date()-Konstruktor übergeben wird, werden Date-Instanzen speziell behandelt. Alle anderen Werte werden in Primitive konvertiert. Wenn das Ergebnis eine Zeichenkette ist, wird es als Datum-Zeichenkette geparst. Andernfalls wird das resultierende Primitive weiter zu einer Zahl erzwungen und als Zeitstempel behandelt.

Einzelne Datums- und Zeitkomponentenwerte

Wenn mindestens ein Jahr und Monat angegeben sind, gibt diese Form von Date() ein Date-Objekt zurück, dessen Komponentenwerte (Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde) alle aus den folgenden Parametern stammen. Alle fehlenden Felder erhalten den niedrigstmöglichen Wert (1 für Tag und 0 für alle anderen Komponenten). Die Parameterwerte werden alle gegen die lokale Zeitzone, anstatt UTC, ausgewertet. Date.UTC() akzeptiert ähnliche Parameter, interpretiert die Komponenten jedoch als UTC und gibt einen Zeitstempel zurück.

Wenn ein Parameter seine definierten Grenzen überschreitet, "trägt er über". Zum Beispiel, wenn ein monthIndex größer als 11 übergeben wird, werden diese Monate dazu führen, dass das Jahr inkrementiert wird; wenn minutes größer als 59 übergeben wird, wird hours entsprechend inkrementiert usw. Daher wird new Date(1990, 12, 1) den 1. Januar 1991 zurückgeben; new Date(2020, 5, 19, 25, 65) wird 2:05 Uhr morgens am 20. Juni 2020 zurückgeben.

Ähnlich, wenn ein Parameter unterläuft, "leiht er von den höheren Positionen". Zum Beispiel wird new Date(2020, 5, 0) den 31. Mai 2020 zurückgeben.

year

Ganzzahliger Wert, der das Jahr darstellt. Werte von 0 bis 99 entsprechen den Jahren 1900 bis 1999. Alle anderen Werte sind das tatsächliche Jahr. Siehe das Beispiel.

monthIndex

Ganzzahliger Wert, der den Monat darstellt, beginnend bei 0 für Januar bis 11 für Dezember.

day Optional

Ganzzahliger Wert, der den Tag des Monats darstellt. Standardmäßig 1.

hours Optional

Ganzzahliger Wert zwischen 0 und 23, der die Stunde des Tages darstellt. Standardmäßig 0.

minutes Optional

Ganzzahliger Wert, der das Minuten-Segment einer Zeit darstellt. Standardmäßig 0.

seconds Optional

Ganzzahliger Wert, der das Sekunden-Segment einer Zeit darstellt. Standardmäßig 0.

milliseconds Optional

Ganzzahliger Wert, der das Millisekunden-Segment einer Zeit darstellt. Standardmäßig 0.

Das Aufrufen von new Date() (dem Date()-Konstruktor) gibt ein Date Objekt zurück. Wenn es mit einer ungültigen Datumszeichenkette aufgerufen wird, oder wenn das zu konstruierende Datum einen Zeitstempel von weniger als -8,640,000,000,000,000 oder mehr als 8,640,000,000,000,000 Millisekunden hätte, gibt es ein ungültiges Datum zurück (ein Date-Objekt, dessen toString() Methode "Invalid Date" zurückgibt und dessen valueOf() Methode NaN zurückgibt).

Das Aufrufen der Date()-Funktion (ohne das new Schlüsselwort) gibt eine Zeichenkettenrepräsentation des aktuellen Datums und der aktuellen Uhrzeit zurück, genauso wie new Date().toString() es tut. Alle Argumente, die in einem Date()-Funktionsaufruf (ohne das new Schlüsselwort) übergeben werden, werden ignoriert; unabhängig davon, ob es mit einer ungültigen Datumszeichenkette aufgerufen wird — oder sogar mit einem beliebigen Objekt oder anderem Primitive als Argument aufgerufen — es gibt immer eine Zeichenkettenrepräsentation des aktuellen Datums und der aktuellen Uhrzeit zurück.

Um Schutz vor Timingangriffen und Fingerabdrücken zu bieten, kann die Präzision von new Date() je nach Browsereinstellungen gerundet werden. In Firefox ist die Einstellung privacy.reduceTimerPrecision standardmäßig aktiviert und beträgt standardmäßig 2 ms. Sie können auch privacy.resistFingerprinting aktivieren, in diesem Fall wird die Präzision 100 ms oder der Wert von privacy.resistFingerprinting.reduceTimerPrecision.microseconds, je nachdem, welcher größer ist.

Zum Beispiel wird bei reduzierter Zeitpräzision das Ergebnis von new Date().getTime() immer ein Vielfaches von 2 sein oder ein Vielfaches von 100 (oder privacy.resistFingerprinting.reduceTimerPrecision.microseconds) mit aktivierter privacy.resistFingerprinting.

// reduced time precision (2ms) in Firefox 60
new Date().getTime();
// Might be:
// 1519211809934
// 1519211810362
// 1519211811670
// …

// reduced time precision with `privacy.resistFingerprinting` enabled
new Date().getTime();
// Might be:
// 1519129853500
// 1519129858900
// 1519129864400
// …

Die folgenden Beispiele zeigen verschiedene Möglichkeiten, JavaScript-Daten zu erstellen:

const today = new Date();
const birthday = new Date("December 17, 1995 03:24:00"); // DISCOURAGED: may not work in all runtimes
const birthday = new Date("1995-12-17T03:24:00"); // This is standardized and will work reliably
const birthday = new Date(1995, 11, 17); // the month is 0-indexed
const birthday = new Date(1995, 11, 17, 3, 24, 0);
const birthday = new Date(628021800000); // passing epoch timestamp

Wenn der Date()-Konstruktor mit einem Parameter aufgerufen wird, der keine Date-Instanz ist, wird er in ein Primitive umgewandelt und dann überprüft, ob es eine Zeichenkette ist. Zum Beispiel, new Date(undefined) unterscheidet sich von new Date():

console.log(new Date(undefined)); // Invalid Date

Das liegt daran, dass undefined bereits ein Primitive ist, aber keine Zeichenkette, also wird es in eine Zahl erzwungen, die NaN ist und daher kein gültiger Zeitstempel. Andererseits wird null zu 0 erzwungen.

console.log(new Date(null)); // 1970-01-01T00:00:00.000Z

Arrays würden über Array.prototype.toString() in eine Zeichenkette umgewandelt, die die Elemente mit Kommas verbindet. Allerdings ist die resultierende Zeichenkette für ein Array mit mehr als einem Element keine gültige ISO 8601-Datumszeichenkette, sodass das Parsing-Verhalten implementierungsabhängig wäre. Übergeben Sie keine Arrays an den Date()-Konstruktor.

console.log(new Date(["2020-06-19", "17:13"]));
// 2020-06-19T17:13:00.000Z in Chrome, since it recognizes "2020-06-19,17:13"
// "Invalid Date" in Firefox

• Date