Diestatische MethodeDate.UTC() akzeptiert Parameter, die die Komponenten von Datum und Uhrzeit ähnlich demDate-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 von0 bis99 werden den Jahren1900 bis1999 zugeordnet. Alle anderen Werte sind das tatsächliche Jahr. Siehe dasBeispiel.

monthIndexOptional

Ganzzahl, die den Monat darstellt, beginnend mit0 für Januar bis11 für Dezember. Standardmäßig0.

dayOptional

Ganzzahl, die den Tag des Monats darstellt. Standardmäßig1.

hoursOptional

Ganzzahl zwischen0 und23, die die Stunde des Tages darstellt. Standardmäßig0.

minutesOptional

Ganzzahl, die das Minutensegment einer Uhrzeit darstellt. Standardmäßig0.

secondsOptional

Ganzzahl, die das Sekundensegment einer Uhrzeit darstellt. Standardmäßig0.

millisecondsOptional

Ganzzahl, die das Millisekundensegment einer Uhrzeit darstellt. Standardmäßig0.

Rückgabewert

Eine Zahl, die denZeitstempel des angegebenen Datums darstellt. GibtNaN zurück, wenn das Datumungültig ist.

Beschreibung

Jahre zwischen0 und99 werden in ein Jahr des 20. Jahrhunderts(1900 + year) konvertiert. Zum Beispiel wird95 in das Jahr1995 konvertiert.

Die MethodeUTC() unterscheidet sich vomDate()-Konstruktor in drei Punkten:

1. Date.UTC() verwendet die koordinierte Weltzeit anstelle der lokalen Zeit.
2. Date.UTC() gibt einen Zeitwert als Zahl zurück, anstatt einDate-Objekt zu erzeugen.
3. Wenn nur eine Zahl übergeben wird, interpretiertDate.UTC() sie als Jahr statt als Zeitstempel.

Wenn ein Parameter außerhalb des erwarteten Bereichs liegt, aktualisiert die MethodeUTC() die anderen Parameter, um den Wert auszugleichen. Zum Beispiel wird, wenn15 fürmonthIndex verwendet wird, das Jahr um 1 erhöht(year + 1) und3 wird für den Monat verwendet.

DaUTC() eine statische Methode vonDate ist, verwenden Sie sie immer alsDate.UTC() und nicht als Methode eines von Ihnen erstelltenDate-Objekts.

Beispiele

Verwendung von Date.UTC()

Die folgende Anweisung erstellt einDate-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 demDate()-Konstruktor konsistent hielten, der ein einzelnes Argument nicht als Jahreszahl interpretiert. Implementierungen müssen nun den ausgelassenenmonthIndex als0 behandeln, anstatt ihn inNaN zu erzwingen.

Date.UTC(2017); // 1483228800000

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Date.parse()
• Date