Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Date.prototype.getFullYear : année locale complète

getFullYear renvoie le numéro complet de l’année en heure locale, sans l’ancien décalage de 1900.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

date.getFullYear()

date.getFullYear() renvoie l’année locale comme Number, par exemple 2024. Contrairement à getYear() qui est obsolète, elle ne soustrait pas 1900. Le fuseau compte près du changement d’année ; utilisez getUTCFullYear() pour UTC. L’année 0 et les années négatives sont admises par le modèle temporel ECMAScript.

La méthode ne prend aucun argument, ne modifie pas la date et ignore les arguments supplémentaires. Elle renvoie NaN pour un Date invalide. Un receiver sans état interne Date, tel que Date.prototype.getFullYear.call({}), lève TypeError.

Utilisez-la pour grouper ou afficher une année locale, en sachant qu’une année sans mois, jour et fuseau n’identifie pas un instant. La méthode existe depuis ECMAScript 1.

Exemples

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()));

Résultat

1999
2000 11 31
true

Sources