CKTIS / JavaScript
Date.prototype.getFullYear: volledig lokaal jaar
getFullYear geeft het volledige jaartal in lokale tijd, zonder de historische verschuiving van 1900.
Versie: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
date.getFullYear()date.getFullYear() geeft het lokale jaar als Number, bijvoorbeeld 2024. Anders dan het verouderde getYear() trekt het geen 1900 af. De tijdzone telt rond een jaargrens; gebruik getUTCFullYear() voor UTC. Jaar 0 en negatieve jaren zijn toegestaan in het ECMAScript-tijdmodel.
De methode heeft geen argumenten, wijzigt de datum niet en negeert extra argumenten. Voor een ongeldige Date geeft ze NaN. Een receiver zonder interne Date-status, zoals Date.prototype.getFullYear.call({}), werpt TypeError.
Gebruik haar om een lokaal jaar te groeperen of tonen; een jaar zonder maand, dag en zone bepaalt geen tijdstip. De methode bestaat sinds ECMAScript 1.
Voorbeelden
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()));Resultaat
1999 2000 11 31 true