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

js
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.

js
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.

js
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.

js
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.

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

Spécifications

Specification
ECMAScript Language Specification
# sec-date.prototype.getyear

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi