Date.UTC()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Date.UTC() akzeptiert Parameter, die die Datums- und Zeitkomponenten ähnlich wie der Date Konstruktor repräsentieren, behandelt sie jedoch als UTC. Sie gibt die Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 UTC zurück.

Probieren Sie es aus

const utcDate1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));
const utcDate2 = new Date(Date.UTC(0, 0, 0, 0, 0, 0));

console.log(utcDate1.toUTCString());
// Expected output: "Fri, 02 Feb 1996 03:04:05 GMT"

console.log(utcDate2.toUTCString());
// Expected output: "Sun, 31 Dec 1899 00:00:00 GMT"

Syntax

Date.UTC(year)
Date.UTC(year, monthIndex)
Date.UTC(year, monthIndex, day)
Date.UTC(year, monthIndex, day, hours)
Date.UTC(year, monthIndex, day, hours, minutes)
Date.UTC(year, monthIndex, day, hours, minutes, seconds)
Date.UTC(year, monthIndex, day, hours, minutes, seconds, milliseconds)

Parameter

year: Ganzzahlwert, 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 Optional: Ganzzahlwert, der den Monat darstellt, beginnend mit 0 für Januar bis 11 für Dezember. Standard ist 0.
day Optional: Ganzzahlwert, der den Tag des Monats darstellt. Standard ist 1.
hours Optional: Ganzzahlwert zwischen 0 und 23, der die Stunde des Tages darstellt. Standard ist 0.
minutes Optional: Ganzzahlwert, der das Minuten-Segment einer Zeit darstellt. Standard ist 0.
seconds Optional: Ganzzahlwert, der das Sekunden-Segment einer Zeit darstellt. Standard ist 0.
milliseconds Optional: Ganzzahlwert, der das Millisekunden-Segment einer Zeit darstellt. Standard ist 0.

Rückgabewert

Eine Zahl, die den Zeitstempel des angegebenen Datums repräsentiert. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Jahre zwischen 0 und 99 werden in ein Jahr des 20. Jahrhunderts umgewandelt (1900 + year). Zum Beispiel wird 95 in das Jahr 1995 umgewandelt.

Die Methode UTC() unterscheidet sich vom Date() Konstruktor in drei Punkten:

Date.UTC() verwendet die universelle Zeit anstelle der lokalen Zeit.
Date.UTC() gibt einen Zeitwert als Zahl zurück, anstatt ein Date Objekt zu erstellen.
Wenn nur eine Zahl übergeben wird, interpretiert Date.UTC() diese als Jahr und nicht als Zeitstempel.

Wenn ein Parameter außerhalb des erwarteten Bereichs liegt, passt die Methode UTC() die anderen Parameter an, um den Wert aufzunehmen. Wenn beispielsweise 15 für monthIndex verwendet wird, wird das Jahr (year + 1) erhöht und 3 für den Monat verwendet.

Da UTC() eine statische Methode von Date ist, verwenden Sie sie immer als Date.UTC(), anstatt sie als Methode eines erstellten Date-Objekts zu verwenden.

Beispiele

Verwendung von Date.UTC()

Die folgende Anweisung erstellt ein Date Objekt, wobei die Argumente als UTC und nicht als lokal behandelt werden:

const utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

Verhalten von Date.UTC() mit einem Argument

Date.UTC(), wenn es mit einem Argument übergeben wird, hatte früher inkonsistentes Verhalten, weil Implementierungen das Verhalten nur im Einklang mit dem Date() Konstruktor einhielten, der ein einzelnes Argument nicht als Jahreszahl interpretiert. Implementierungen sind nun verpflichtet, einen ausgelassenen monthIndex als 0 zu behandeln, anstatt ihn zu NaN zu zwingen.

Date.UTC(2017); // 1483228800000

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-date.utc