CKTIS / JavaScript
Date.prototype.getFullYear: vollständiges lokales Jahr
getFullYear liefert die vollständige Jahreszahl in lokaler Zeit, ohne den historischen Offset von 1900.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
date.getFullYear()date.getFullYear() liefert das lokale Jahr als Number, zum Beispiel 2024. Anders als das veraltete getYear() zieht es nicht 1900 ab. An einer Jahresgrenze ist die Zeitzone wichtig; für das UTC-Jahr dient getUTCFullYear(). Jahr 0 und negative Jahre sind im ECMAScript-Zeitmodell erlaubt.
Die Methode hat keine Argumente, verändert das Datum nicht und ignoriert zusätzliche Argumente. Bei einem ungültigen Date liefert sie NaN. Ein Receiver ohne internen Date-Zustand, etwa Date.prototype.getFullYear.call({}), führt zu TypeError.
Nutze sie zum Gruppieren oder Anzeigen eines lokalen Kalenderjahrs; eine Jahreszahl ohne Monat, Tag und Zone bezeichnet keinen Zeitpunkt. Die Methode existiert seit ECMAScript 1.
Beispiele
const date = new Date(1999, 11, 31, 12);
console.log(date.getFullYear());
date.setFullYear(2000);
console.log(date.getFullYear(), date.getMonth(), date.getDate());
console.log(Number.isNaN(new Date(NaN).getFullYear()));Ergebnis
1999 2000 11 31 true