Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Date.prototype.getUTCFullYear()

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 Methode getUTCFullYear() von Date-Instanzen gibt das Jahr dieses Datums gemäß der koordinierten Weltzeit (UTC) zurück.

Probieren Sie es aus

const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");
const date2 = new Date("December 31, 1975, 23:15:30 GMT-11:00");

console.log(date1.getUTCFullYear());
// Expected output: 1975

console.log(date2.getUTCFullYear());
// Expected output: 1976

Syntax

js
getUTCFullYear()

Parameter

Keine.

Rückgabewert

Eine ganze Zahl, die das Jahr des angegebenen Datums gemäß der koordinierten Weltzeit (UTC) darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Anders als bei getYear() ist der von getUTCFullYear() zurückgegebene Wert eine absolute Zahl. Für Datumsangaben zwischen den Jahren 1000 und 9999 gibt getUTCFullYear() eine vierstellige Zahl zurück, beispielsweise 1995. Verwenden Sie diese Funktion, um sicherzustellen, dass die Jahreszahl auch für Jahre nach 2000 korrekt ist.

Beispiele

Verwendung von getUTCFullYear()

Das folgende Beispiel weist der Variablen year den vierstelligen Wert des aktuellen Jahres zu.

js
const today = new Date();
const year = today.getUTCFullYear();

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-date.prototype.getutcfullyear

Browser-Kompatibilität

Siehe auch