Accueil >JavaScript >Référence JS – méthodes et objets >Date.prototype.setFullYear()

Date.prototype.setFullYear()

date.setFullYear(year, monthIndex, day)

Définit l’année (et en option le mois et le jour) en heure locale.

La méthode modifie la date sur laquelle elle est appelée et renvoie le nouvel horodatage en millisecondes.

Paramètres

  • year – l’année sur quatre chiffres.
  • monthIndex, day – facultatifs (mois depuis 0).

Valeur de retour

Un nombre – le nouvel horodatage en millisecondes.

Exemples

const expiry = new Date(2026, 9, 6);
expiry.setFullYear(expiry.getFullYear() + 1);
console.log(expiry.getDate(), expiry.getMonth() + 1, expiry.getFullYear());
const leap = new Date(2028, 1, 29);
leap.setFullYear(2029);
console.log(leap.getDate(), leap.getMonth() + 1);

Résultat :

6 10 2027
1 3

Points d’attention

  • Les valeurs hors limites passent à l’unité supérieure (par exemple le 32e jour devient le 1er du mois suivant) – pratique pour additionner, mais cela masque aussi une erreur.

Prise en charge par les navigateurs

Baseline – largement disponible : fonctionne dans tous les navigateurs courants, et depuis longtemps (au plus tard depuis 2015). Depuis la version : Chrome 1, Firefox 1, Safari 1 ; Node.js 0.10.0. État : octobre 2026 (MDN browser-compat-data).

Voir aussi :
Date.prototype.setMonth()
Date.prototype.setDate()
Date.prototype.getFullYear()