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
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.
const today = new Date();
const year = today.getUTCFullYear();
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.getutcfullyear> |