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 darstellen, 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
-
Ganzzahl, die das Jahr darstellt. Werte von
0
bis99
entsprechen den Jahren1900
bis1999
. Alle anderen Werte sind das tatsächliche Jahr. Siehe das Beispiel. monthIndex
Optional-
Ganzzahl, die den Monat darstellt, beginnend bei
0
für Januar bis11
für Dezember. Standardwert ist0
. day
Optional-
Ganzzahl, die den Tag des Monats darstellt. Standardwert ist
1
. hours
Optional-
Ganzzahl zwischen
0
und23
, die die Stunde des Tages darstellt. Standardwert ist0
. minutes
Optional-
Ganzzahl, die den Minutenanteil einer Zeit darstellt. Standardwert ist
0
. seconds
Optional-
Ganzzahl, die den Sekundenanteil einer Zeit darstellt. Standardwert ist
0
. milliseconds
Optional-
Ganzzahl, die den Millisekundenanteil einer Zeit darstellt. Standardwert ist
0
.
Rückgabewert
Eine Zahl, die den Zeitstempel des angegebenen Datums darstellt. Gibt NaN
zurück, wenn das Datum ungültig ist.
Beschreibung
Jahre zwischen 0
und 99
werden in ein Jahr im 20. Jahrhundert umgewandelt (1900 + year)
. Beispielsweise wird 95
in das Jahr 1995
umgewandelt.
Die Methode UTC()
unterscheidet sich vom Date()
-Konstruktor in drei Punkten:
Date.UTC()
verwendet universelle Zeit (UTC) anstelle der lokalen Zeit.Date.UTC()
gibt einen Zeitwert als Zahl zurück, anstelle einesDate
-Objekts.- 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, aktualisiert die Methode UTC()
die anderen Parameter, um den Wert zu berücksichtigen. Wenn beispielsweise 15
für monthIndex
verwendet wird, wird das Jahr um 1 erhöht (year + 1)
und 3
wird für den Monat verwendet.
Da UTC()
eine statische Methode von Date
ist, wird sie immer als Date.UTC()
verwendet, anstatt als Methode eines erstellten Date
-Objekts.
Beispiele
Verwendung von Date.UTC()
Die folgende Anweisung erstellt ein Date
-Objekt, wobei die Argumente als UTC anstelle der lokalen Zeit behandelt werden:
const utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));
Verhalten von Date.UTC() mit einem Argument
Date.UTC()
hatte früher bei einem Argument inkonsistentes Verhalten, da Implementierungen nur das Verhalten beibehielten, das mit dem Date()
-Konstruktor konsistent war. Dieser interpretiert ein einzelnes Argument nicht als Jahr. Implementierungen müssen nun ein weggelassenes monthIndex
als 0
behandeln, anstatt es in NaN
zu erzwingen.
Date.UTC(2017); // 1483228800000
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-date.utc |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
UTC | ||||||||||||||
monthIndex defaults to 0 |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support