Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Date.prototype.getYear()

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 getYear() renvoie l'année de la date renseignée, d'après l'heure locale. Parce que getYear() ne renvoie pas l'année complète (« bug de l'an 2000 »), cette méthode n'est plus utilisée et doit être remplacée par getFullYear.

Syntaxe

dateObj.getYear()

Valeur de retour

Un nombre représentant l'année de la date indiquée, selon l'heure locale, auquel on a soustrait 1900.

Description

La méthode getYear() renvoie l'année moins 1900 ; par conséquent :

  • Pour les années supérieures ou égales à 2000, la valeur renvoyée par getYear() est supérieure ou égale à 100. Par exemple, si l'année est 2026, getYear() renvoie 126.
  • Pour les années entre 1900 et 1999 incluses, la valeur renvoyée par getYear() est comprise entre 0 et 99. Par exemple, si l'année est 1976, getYear() renvoie 76.
  • Pour les années inférieures à 1900, la valeur renvoyée par getYear() est négative. Par exemple, si l'année est 1800, getYear() renvoie -100.

Pour prendre en compte les années avant et après 2000, il vaut mieux utiliser getFullYear() au lieu de getYear afin que l'année soit spécifiée en entier.

Rétrocompatibilité

Comportement dans JavaScript 1.2 et versions antérieures

La méthode getYear() renvoyait soit une année en deux chiffres, soit une année en quatre chiffres :

  • Pour les années entre 1900 et 1999 incluses, la valeur renvoyée par getYear() était l'année moins 1900. Par exemple, si l'année était 1976, la valeur renvoyée était 76.
  • Pour les années inférieures à 1900 ou supérieures à 1999, la valeur renvoyée par getYear était l'année en quatre chiffres. Par exemple, si l'année était 1856, la valeur renvoyée était 1856. Si l'année était 2026, la valeur renvoyée était 2026.

Exemples

Années entre 1900 et 1999

La seconde instruction assigne la valeur 95 à la variable annee.

var noel = new Date("December 25, 1995 23:15:00");
var annee = noel.getYear(); // renvoie 95

Années après 1999

La seconde instruction assigne la valeur 100 à la variable annee.

var noel = new Date("December 25, 2000 23:15:00");
var annee = noel.getYear(); // renvoie 100

Années avant 1900

La seconde instruction assigne la valeur -100 à la variable annee.

var noel = new Date("December 25, 1800 23:15:00");
var annee = noel.getYear(); // renvoie -100

Définition et lecture d'une année entre 1900 et 1999

La troisième instruction assigne la valeur 95 à la variable annee, représentant l'année 1995.

var noel = new Date("December 25, 1800 23:15:00");
var noel.setYear(95);
var annee = noel.getYear(); // renvoie 95 

Specifications

Spécification État 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.getYear' dans cette spécification.
Standard Défini dans l'annexe informative sur la compatibilité.
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.getYear' dans cette spécification.
Standard Défini dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Date.prototype.getYear' 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)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, tregagnon, Jeremie, BenoitL
 Dernière mise à jour par : SphinxKnight,