From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../reference/global_objects/date/getyear/index.md | 139 +++++++++------------ 1 file changed, 57 insertions(+), 82 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/date/getyear') diff --git a/files/fr/web/javascript/reference/global_objects/date/getyear/index.md b/files/fr/web/javascript/reference/global_objects/date/getyear/index.md index 438c7107cd..30f96ed639 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getyear/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getyear/index.md @@ -11,116 +11,91 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getYear original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getYear --- -
{{JSRef}} {{Deprecated_header}}
+{{JSRef}} {{Deprecated_header}} -

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 {{jsxref("Date.getFullYear", "getFullYear")}}.

+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 {{jsxref("Date.getFullYear", "getFullYear")}}. -

Syntaxe

+## Syntaxe -
dateObj.getYear()
+ dateObj.getYear() -

Valeur de retour

+### Valeur de retour -

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

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

Description

+## Description -

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

+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 {{jsxref("Date.getFullYear", "getFullYear()")}} au lieu de getYear afin que l'année soit spécifiée en entier.

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

Rétrocompatibilité

+## Rétrocompatibilité -

Comportement dans JavaScript 1.2 et versions antérieures

+### 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 :

+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

+## Exemples -

Années entre 1900 et 1999

+### Années entre 1900 et 1999 -

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

+La seconde instruction assigne la valeur 95 à la variable `annee`. -
var noel = new Date("December 25, 1995 23:15:00");
+```js
+var noel = new Date("December 25, 1995 23:15:00");
 var annee = noel.getYear(); // renvoie 95
-
+``` -

Années après 1999

+### Années après 1999 -

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

+La seconde instruction assigne la valeur 100 à la variable `annee`. -
var noel = new Date("December 25, 2000 23:15:00");
+```js
+var noel = new Date("December 25, 2000 23:15:00");
 var annee = noel.getYear(); // renvoie 100
-
+``` -

Années avant 1900

+### Années avant 1900 -

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

+La seconde instruction assigne la valeur -100 à la variable `annee`. -
var noel = new Date("December 25, 1800 23:15:00");
+```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

+### 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.

+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");
+```js
+var noel = new Date("December 25, 1800 23:15:00");
 var noel.setYear(95);
 var annee = noel.getYear(); // renvoie 95
-
- -

Specifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES1')}}{{Spec2('ES1')}}Définition initiale. Implémentée avec JavaScript 1.3.
{{SpecName('ES5.1', '#sec-B.2.4', 'Date.prototype.getYear')}}{{Spec2('ES5.1')}}Défini dans l'annexe informative sur la compatibilité.
{{SpecName('ES6', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}{{Spec2('ES6')}}Défini dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.
{{SpecName('ESDraft', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Date.getYear")}}

- -

Voir aussi

- - +``` + +## Specifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------------ | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-B.2.4', 'Date.prototype.getYear')}} | {{Spec2('ES5.1')}} | Défini dans l'annexe informative sur la compatibilité. | +| {{SpecName('ES6', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}} | {{Spec2('ES6')}} | Défini dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. | +| {{SpecName('ESDraft', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getYear")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getFullYear()")}} +- {{jsxref("Date.prototype.getUTCFullYear()")}} +- {{jsxref("Date.prototype.setYear()")}} -- cgit v1.2.3-54-g00ecf