Date.UTC() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Date.UTC()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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.

In diesem Artikel

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

js
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.

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 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.
Wenn nur eine Zahl übergeben wird, interpretiert 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.

Beispiele

Verwendung von Date.UTC()

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Date
Konstruktor
1. Date()
Statische Methoden
1. now()
2. parse()
3. UTC()
Instanzmethoden
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor