Date.prototype.setFullYear()

La méthode setFullYear() définit l'année complête pour une date, d'après l'heure locale.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

Syntaxe

dateObj.setFullYear(valeurAnnée[, valeurMois[, valeurJour]])

Paramètres

valeurAnnée

Un entier indiquant la valeur numérique de l'année, par exemple, 1995.

valeurMois

Paramètre optionnel qui représente un entier entre 0 et 11, représentant les mois de janvier à décembre.

valeurJour

Paramè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 indiquer valeurMois.

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ètres valeurMois et valeurJour. Les valeurs renvoyées par les méthodes getMonth() et getDate() 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 pour valeurMois, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois.

Exemples

Utiliser setFullYear()

var leGrandJour = new Date();
leGrandJour.setFullYear(1997);

Spécifications

Compatibilité des navigateurs

Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.

Voir aussi

• Date.prototype.getUTCFullYear()
• Date.prototype.setUTCFullYear()
• Date.prototype.setYear()