diff options
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/date/getyear/index.html')
-rw-r--r-- | files/fr/web/javascript/reference/global_objects/date/getyear/index.html | 127 |
1 files changed, 127 insertions, 0 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/date/getyear/index.html b/files/fr/web/javascript/reference/global_objects/date/getyear/index.html new file mode 100644 index 0000000000..a890eaeb7e --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/date/getyear/index.html @@ -0,0 +1,127 @@ +--- +title: Date.prototype.getYear() +slug: Web/JavaScript/Reference/Objets_globaux/Date/getYear +tags: + - Date + - Déprécié + - JavaScript + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getYear +--- +<div>{{JSRef}} {{Deprecated_header}}</div> + +<p>La méthode <strong><code>getYear()</code></strong> renvoie l'année de la date renseignée, d'après l'heure locale. Parce que <code>getYear()</code> 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")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">dateObj.getYear()</pre> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Un nombre représentant l'année de la date indiquée, selon l'heure locale, auquel on a soustrait 1900.</p> + +<h2 id="Description">Description</h2> + +<p>La méthode <code>getYear()</code> renvoie l'année moins 1900 ; par conséquent :</p> + +<ul> + <li>Pour les années supérieures ou égales à 2000, la valeur renvoyée par <code>getYear()</code> est supérieure ou égale à 100. Par exemple, si l'année est 2026, <code>getYear()</code> renvoie 126.</li> + <li>Pour les années entre 1900 et 1999 incluses, la valeur renvoyée par <code>getYear()</code> est comprise entre 0 et 99. Par exemple, si l'année est 1976, <code>getYear()</code> renvoie 76.</li> + <li>Pour les années inférieures à 1900, la valeur renvoyée par <code>getYear()</code> est négative. Par exemple, si l'année est 1800, <code>getYear()</code> renvoie -100.</li> +</ul> + +<p>Pour prendre en compte les années avant et après 2000, il vaut mieux utiliser {{jsxref("Date.getFullYear", "getFullYear()")}} au lieu de <code>getYear</code> afin que l'année soit spécifiée en entier.</p> + +<h2 id="Rétrocompatibilité">Rétrocompatibilité</h2> + +<h3 id="Comportement_dans_JavaScript_1.2_et_versions_antérieures">Comportement dans JavaScript 1.2 et versions antérieures</h3> + +<p>La méthode <code>getYear()</code> renvoyait soit une année en deux chiffres, soit une année en quatre chiffres :</p> + +<ul> + <li>Pour les années entre 1900 et 1999 incluses, la valeur renvoyée par <code>getYear()</code> était l'année moins 1900. Par exemple, si l'année était 1976, la valeur renvoyée était 76.</li> + <li>Pour les années inférieures à 1900 ou supérieures à 1999, la valeur renvoyée par <code>getYear</code> é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.</li> +</ul> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Années_entre_1900_et_1999">Années entre 1900 et 1999</h3> + +<p>La seconde instruction assigne la valeur 95 à la variable <code>annee</code>.</p> + +<pre class="brush: js">var noel = new Date("December 25, 1995 23:15:00"); +var annee = noel.getYear(); // renvoie 95 +</pre> + +<h3 id="Années_après_1999">Années après 1999</h3> + +<p>La seconde instruction assigne la valeur 100 à la variable <code>annee</code>.</p> + +<pre class="brush: js">var noel = new Date("December 25, 2000 23:15:00"); +var annee = noel.getYear(); // renvoie 100 +</pre> + +<h3 id="Années_avant_1900">Années avant 1900</h3> + +<p>La seconde instruction assigne la valeur -100 à la variable <code>annee</code>.</p> + +<pre class="brush: js">var noel = new Date("December 25, 1800 23:15:00"); +var annee = noel.getYear(); // renvoie -100 +</pre> + +<h3 id="Définition_et_lecture_d'une_année_entre_1900_et_1999">Définition et lecture d'une année entre 1900 et 1999</h3> + +<p>La troisième instruction assigne la valeur 95 à la variable <code>annee</code>, représentant l'année 1995.</p> + +<pre class="brush: js">var noel = new Date("December 25, 1800 23:15:00"); +var noel.setYear(95); +var annee = noel.getYear(); // renvoie 95 +</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + <tr> + <td>{{SpecName('ES1')}}</td> + <td>{{Spec2('ES1')}}</td> + <td>Définition initiale. Implémentée avec JavaScript 1.3.</td> + </tr> + <tr> + <td>{{SpecName('ES5.1', '#sec-B.2.4', 'Date.prototype.getYear')}}</td> + <td>{{Spec2('ES5.1')}}</td> + <td>Défini dans l'annexe informative sur la compatibilité.</td> + </tr> + <tr> + <td>{{SpecName('ES6', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}</td> + <td>{{Spec2('ES6')}}</td> + <td>Défini dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.</td> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<p class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</p> + +<p>{{Compat("javascript.builtins.Date.getYear")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{jsxref("Date.prototype.getFullYear()")}}</li> + <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setYear()")}}</li> +</ul> |