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 getUTCFullYear()-Methode von Date-Instanzen gibt das Jahr für dieses Datum gemäß 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
getUTCFullYear()
Parameter
Keine.
Rückgabewert
Eine Ganzzahl, die das Jahr für das angegebene 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 den Anforderungen nach dem Jahr 2000 entspricht.
Beispiele
Verwendung von getUTCFullYear()
Das folgende Beispiel weist den vierstelligen Wert des aktuellen Jahres der Variablen year zu.
const today = new Date();
const year = today.getUTCFullYear();
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.getutcfullyear |