Référence de JavaScript 1.5 Core:Objets globaux:Date:getYear

Un article de MDC.

Sommaire 1 Résumé 2 Syntaxe 3 Paramètres 4 Description 5 Compatibilité avec les versions précédentes 5.1 JavaScript 1.2 et versions antérieures 6 Exemples 6.1 Exemple : années entre 1900 et 1999 6.2 Exemple : années au dessus de 1999 6.3 Exemple : années avant 1900 6.4 Exemple : définition et lecture d'une année entre 1900 et 1999 7 Voir aussi

[modifier] Résumé

Renvoie l'année (moins 1900) de la date spécifiée selon l'heure locale.

Méthode de Date
Implémentation :	JavaScript 1.0, NES 2.0 JavaScript 1.3 : dépréciée ; getYear renvoie l'année moins 1900 quelle que soit la date spécifiée.
Version ECMA :	ECMA-262

[modifier] Syntaxe

getYear();

[modifier] Paramètres

Aucun.

[modifier] Description

getYear n'est plus utilisée et a été remplacée par la méthode getFullYear.

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

• Pour les années plus grandes 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 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.

[modifier] Compatibilité avec les versions précédentes

[modifier] 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.

[modifier] Exemples

[modifier] Exemple : années entre 1900 et 1999

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

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

[modifier] Exemple : années au dessus de 1999

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

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

[modifier] Exemple : années avant 1900

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

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

[modifier] Exemple : définition et lecture d'une année entre 1900 et 1999

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

Noel.setYear(95);
annee = Noel.getYear(); // renvoie 95 

[modifier] Voir aussi

getFullYear, getUTCFullYear, setYear.