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 with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Date.prototype.getFullYear()`
* `Date.prototype.getUTCFullYear()`
* `Date.prototype.setYear()`