WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen