Obsolète
Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.
La méthode setYear() définit l'année pour pour la date, selon l'heure locale. setYear() ne définissant pas des années complêtes ( « bug de l'an 2000 » ), elle n'est plus utilisée et a été remplacée par la méthode setFullYear.
Syntaxe
dateObj.setYear(valeurAnnée)
Paramètres
valeurAnnée- Un entier.
Valeur de retour
Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.
Description
Si valeurAnnée est un nombre entre 0 et 99 (inclus), alors l'année de dateObj sera définie à 1900 + valeurAnnée. Sinon, l'année de dateObj sera définie à valeurAnnée.
Exemples
Utiliser setYear()
Les deux premières instructions définissent l'année 1996. La troisième définit l'année 2000.
var leGrandJour = new Date(); leGrandJour.setYear(96); leGrandJour.setYear(1996); leGrandJour.setYear(2000);
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.0. |
| ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype.setYear' dans cette spécification. |
Standard | Définie dans l'annexe informative sur la compatibilité. |
| ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype.setYear' dans cette spécification. |
Standard | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. |
| ECMAScript 2017 Draft (ECMA-262) La définition de 'Date.prototype.setYear' dans cette spécification. |
Projet | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. |
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) |