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 (ECMA-262) La définition de 'Date.prototype.setYear' dans cette spécification. |
Standard évolutif | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. |
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.
| Ordinateur | Mobile | Serveur | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setYear | Chrome Support complet 1 | Edge Support complet 12 | Firefox Support complet 1 | IE Support complet 3 | Opera Support complet 3 | Safari Support complet 1 | WebView Android Support complet 1 | Chrome Android Support complet 18 | Firefox Android Support complet 4 | Opera Android Support complet 10.1 | Safari iOS Support complet 1 | Samsung Internet Android Support complet 1.0 | nodejs Support complet 0.1.100 |
Légende
- Support complet
- Support complet
- Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
- Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.