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 Methode getUTCFullYear() 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 angegebene Datum entsprechend 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, beispielsweise 1995. Verwenden Sie diese Funktion, um sicherzustellen, dass ein Jahr mit den Jahren nach 2000 kompatibel ist.

Beispiele

Verwendung von getUTCFullYear()

Im folgenden Beispiel wird der vierstellige Wert des aktuellen Jahres der Variablen year zugewiesen.

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch