Date.prototype.getUTCFullYear()

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 getUTCFullYear()-Methode von Date-Instanzen gibt das Jahr für dieses Datum entsprechend der Weltzeit 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 für das gegebene Datum gemäß der Weltzeit darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Im Gegensatz zu getYear() ist der von getUTCFullYear() zurückgegebene Wert eine absolute Zahl. Für Daten zwischen den Jahren 1000 und 9999 gibt getFullYear() eine vierstellige Zahl zurück, zum Beispiel 1995. Verwenden Sie diese Funktion, um sicherzustellen, dass ein Jahr mit den Jahren nach 2000 übereinstimmt.

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

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.getutcfullyear

Browser-Kompatibilität

Siehe auch