La méthode setFullYear()
définit l'année complête pour une date, d'après l'heure locale.
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 2017 Draft (ECMA-262) La définition de 'Date.prototype.setFullYear' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |