Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Date.prototype.setFullYear()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthodesetFullYear() définit l'année complête pour une date, d'après l'heure locale.
Exemple interactif
const event = new Date("August 19, 1975 23:15:30");event.setFullYear(1969);console.log(event.getFullYear());// Expected output: 1969event.setFullYear(0);console.log(event.getFullYear());// Expected output: 0Syntaxe
dateObj.setFullYear(valeurAnnée[, valeurMois[, valeurJour]])Paramètres
valeurAnnéeUn entier indiquant la valeur numérique de l'année, par exemple, 1995.
valeurMoisParamètre optionnel qui représente un entier entre 0 et 11, représentant les mois de janvier à décembre.
valeurJourParamètre optionnel qui représente un entier entre 1 et 31 représentant le jour du mois. Si vous indiquez une
valeurJour, vous devez aussi indiquervaleurMois.
Valeur de retour
Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date mise à jour.
Description
Si vous n'indiquez pas les paramètresvaleurMois etvaleurJour. Les valeurs renvoyées par les méthodesgetMonth() etgetDate() seront utilisées.
Si un des paramètres que vous indiquez est en dehors des limites attendues,setFullYear() tentera de mettre à jour la date en conséquence. Pa exemple, si vous indiquez 15 pourvaleurMois, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois.
Exemples
UtilisersetFullYear()
var leGrandJour = new Date();leGrandJour.setFullYear(1997);Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setfullyear |