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 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è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
Spécification | Statut | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype.setFullYear' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype.setFullYear' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'Date.prototype.setFullYear' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
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.