Date : méthode getYear()
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets.
The getYear() and setYear() methods use a truncated number instead of the actual year number, known as a year 2000 problem.
Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
La méthode getYear() des instances de Date retourne l'année pour cette date selon l'heure locale. Comme getYear() ne retourne pas les années complètes (problème de l'an 2000), elle est obsolète et a été remplacée par la méthode getFullYear().
Syntaxe
getYear()
Paramètres
Aucun.
Valeur de retour
Un entier représentant l'année pour la date indiquée selon l'heure locale, auquel on a soustrait 1900. Retourne NaN si la date est invalide.
- Pour les années supérieures ou égales à 2000, la valeur est 100 ou plus. Par exemple, si l'année est 2026,
getYear()retourne 126. - Pour les années comprises entre 1900 et 1999 inclus, la valeur retournée par
getYear()est comprise entre 0 et 99. Par exemple, si l'année est 1976,getYear()retourne 76. - Pour les années inférieures à 1900, la valeur retournée par
getYear()est inférieure à 0. Par exemple, si l'année est 1800,getYear()retourne -100.
Cette méthode retourne essentiellement la valeur de getFullYear() moins 1900. Il est préférable d'utiliser getFullYear() afin que l'année soit définie en entier.
Exemples
Années entre 1900 et 1999
La seconde instruction assigne la valeur 95 à la variable annee.
const noel = new Date("December 25, 1995 23:15:00");
const annee = noel.getYear(); // retourne 95
Années après 1999
La seconde instruction assigne la valeur 100 à la variable annee.
const noel = new Date("December 25, 2000 23:15:00");
const annee = noel.getYear(); // retourne 100
Années avant 1900
La seconde instruction assigne la valeur -100 à la variable annee.
const noel = new Date("December 25, 1800 23:15:00");
const annee = noel.getYear(); // retourne -100
Définir et lire une année entre 1900 et 1999
La troisième instruction assigne la valeur 95 à la variable annee, représentant l'année 1995.
const noel = new Date("December 25, 1800 23:15:00");
const noel.setYear(95);
const annee = noel.getYear(); // retourne 95
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification # sec-date.prototype.getyear |