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 gemäß der universellen Zeit 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 gemäß der universellen Zeit darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Anders als 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()

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

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch