Baseline Widely available
Die statische Methode Date.UTC()
akzeptiert Parameter, die die Komponenten von Datum und Uhrzeit ähnlich dem 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.
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
bis 99
werden den Jahren 1900
bis 1999
zugeordnet. Alle anderen Werte sind das tatsächliche Jahr. Siehe das Beispiel.
monthIndex
Optional
Ganzzahl, die den Monat darstellt, beginnend mit 0
für Januar bis 11
für Dezember. StandardmäÃig 0
.
day
Optional
Ganzzahl, die den Tag des Monats darstellt. StandardmäÃig 1
.
hours
Optional
Ganzzahl zwischen 0
und 23
, die die Stunde des Tages darstellt. StandardmäÃig 0
.
minutes
Optional
Ganzzahl, die das Minutensegment einer Uhrzeit darstellt. StandardmäÃig 0
.
seconds
Optional
Ganzzahl, die das Sekundensegment einer Uhrzeit darstellt. StandardmäÃig 0
.
milliseconds
Optional
Ganzzahl, die das Millisekundensegment einer Uhrzeit darstellt. StandardmäÃig 0
.
Eine Zahl, die den Zeitstempel des angegebenen Datums darstellt. Gibt NaN
zurück, wenn das Datum ungültig ist.
Jahre zwischen 0
und 99
werden in ein Jahr des 20. Jahrhunderts (1900 + year)
konvertiert. Zum Beispiel wird 95
in das Jahr 1995
konvertiert.
Die Methode UTC()
unterscheidet sich vom Date()
-Konstruktor in drei Punkten:
Date.UTC()
verwendet die koordinierte Weltzeit anstelle der lokalen Zeit.Date.UTC()
gibt einen Zeitwert als Zahl zurück, anstatt ein Date
-Objekt zu erzeugen.Date.UTC()
sie als Jahr statt als Zeitstempel.Wenn ein Parameter auÃerhalb des erwarteten Bereichs liegt, aktualisiert die Methode UTC()
die anderen Parameter, um den Wert auszugleichen. Zum Beispiel wird, wenn 15
für monthIndex
verwendet 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, verwenden Sie sie immer als Date.UTC()
und nicht als Methode eines von Ihnen erstellten Date
-Objekts.
Die folgende Anweisung erstellt ein Date
-Objekt mit den als UTC behandelten Argumenten anstelle der lokalen:
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 aufgerufen wird, hatte früher inkonsistentes Verhalten, weil Implementierungen nur das Verhalten mit dem Date()
-Konstruktor konsistent hielten, der ein einzelnes Argument nicht als Jahreszahl interpretiert. Implementierungen müssen nun den ausgelassenen monthIndex
als 0
behandeln, anstatt ihn in NaN
zu erzwingen.
Date.UTC(2017); // 1483228800000
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4