diff options
author | julieng <julien.gattelier@gmail.com> | 2021-08-03 08:03:23 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-09-03 08:08:25 +0200 |
commit | bf8e099b9c8b3c60d60b3712b4fc97b052c39887 (patch) | |
tree | c101746d082c9581c94f5937519c7d0e2f4af8cb /files/fr/web/javascript/reference/global_objects/date | |
parent | 844f5103992238c0c23203286dad16a466e89c97 (diff) | |
download | translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.gz translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.bz2 translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.zip |
convert content to md
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/date')
52 files changed, 2191 insertions, 3461 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/date/@@toprimitive/index.md b/files/fr/web/javascript/reference/global_objects/date/@@toprimitive/index.md index ee85093529..574dd32262 100644 --- a/files/fr/web/javascript/reference/global_objects/date/@@toprimitive/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/@@toprimitive/index.md @@ -10,57 +10,39 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive original_slug: Web/JavaScript/Reference/Objets_globaux/Date/@@toPrimitive --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>[@@toPrimitive]()</strong></code> permet de convertir un objet <code>Date</code> en une valeur primitive.</p> +La méthode **`[@@toPrimitive]()`** permet de convertir un objet `Date` en une valeur primitive. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>Date()[Symbol.toPrimitive](hint); -</var></pre> + Date()[Symbol.toPrimitive](hint); -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur primitive de l'objet {{jsxref("Date")}}. Selon la valeur de l'argument, la méthode peut renvoyer une chaîne de caractères ou un nombre.</p> +La valeur primitive de l'objet {{jsxref("Date")}}. Selon la valeur de l'argument, la méthode peut renvoyer une chaîne de caractères ou un nombre. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>[@@toPrimitive]()</code> de {{jsxref("Date")}} renvoie une valeur primitive qui est un nombre ou une chaîne de caractère.</p> +La méthode `[@@toPrimitive]()` de {{jsxref("Date")}} renvoie une valeur primitive qui est un nombre ou une chaîne de caractère. -<p>Si le paramètre <code>hint</code> vaut <code>"string"</code> ou <code>"default"</code>, <code>[@@toPrimitive]()</code> tentera d'appeler la méthode {{jsxref("Object.prototype.toString()", "toString")}}, si la propriété <code>toString()</code> n'existe pas, elle tentera alors d'appeler la méthode {{jsxref("Object.prototype.valueOf()", "valueOf")}}, si cette dernière n'existe pas non plus, <code>[@@toPrimitive]()</code> lèvera une exception {{jsxref("TypeError")}}.</p> +Si le paramètre `hint` vaut `"string"` ou `"default"`, `[@@toPrimitive]()` tentera d'appeler la méthode {{jsxref("Object.prototype.toString()", "toString")}}, si la propriété `toString()` n'existe pas, elle tentera alors d'appeler la méthode {{jsxref("Object.prototype.valueOf()", "valueOf")}}, si cette dernière n'existe pas non plus, `[@@toPrimitive]()` lèvera une exception {{jsxref("TypeError")}}. -<p>Si le paramètre <code>hint</code> vaut <code>"number"</code>, <code>[@@toPrimitive]()</code> tentera d'abord un appel à <code>valueOf()</code> puis ensuite un appel à <code>toString()</code>.</p> +Si le paramètre `hint` vaut `"number"`, `[@@toPrimitive]()` tentera d'abord un appel à `valueOf()` puis ensuite un appel à `toString()`. -<p>Le moteur JavaScript appelle la méthode <code>[@@toPrimitive]()</code> afin de convertir un objet en une valeur primitive. Il est rarement nécessaire d'appeler <code>[@@toPrimitive]()</code> explicitement dans son propre code, le moteur JavaScript l'utilisera automatiquement lorsqu'il détectera un objet là où une valeur primitive est attendue.</p> +Le moteur JavaScript appelle la méthode `[@@toPrimitive]()` afin de convertir un objet en une valeur primitive. Il est rarement nécessaire d'appeler `[@@toPrimitive]()` explicitement dans son propre code, le moteur JavaScript l'utilisera automatiquement lorsqu'il détectera un objet là où une valeur primitive est attendue. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<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('ES6', '#sec-date.prototype-@@toprimitive', 'Date.prototype.@@toPrimitive')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype-@@toprimitive', 'Date.prototype.@@toPrimitive')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES6', '#sec-date.prototype-@@toprimitive', 'Date.prototype.@@toPrimitive')}} | {{Spec2('ES6')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-date.prototype-@@toprimitive', 'Date.prototype.@@toPrimitive')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.Date.@@toPrimitive")}}</p> +{{Compat("javascript.builtins.Date.@@toPrimitive")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("Symbol.toPrimitive")}}</li> -</ul> +- {{jsxref("Symbol.toPrimitive")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getdate/index.md b/files/fr/web/javascript/reference/global_objects/date/getdate/index.md index 7c87be827c..934bca97de 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getdate/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getdate/index.md @@ -10,76 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getDate original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getDate --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getDate()</strong></code> retourne le jour du mois pour la date spécifiée d'après l'heure locale.</p> +La méthode **`getDate()`** retourne le jour du mois pour la date spécifiée d'après l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-getdate.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getdate.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getDate()</pre> + dateObj.getDate() -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Aucun.</p> +Aucun. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 1 et 31 correspondant au jour du mois de la date indiquée selon l'heure locale.</p> +Un entier entre 1 et 31 correspondant au jour du mois de la date indiquée selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getDate()">Utiliser <code>getDate()</code></h3> +### Utiliser `getDate()` -<p>La seconde instruction ci-dessous affecte la valeur 25 à la variable <code>jour</code>, d'après la valeur de l'objet {{jsxref("Date")}} <code>Noel95</code>.</p> +La seconde instruction ci-dessous affecte la valeur 25 à la variable `jour`, d'après la valeur de l'objet {{jsxref("Date")}} `Noel95`. -<pre class="brush: js">var Noel95 = new Date("December 25, 1995 23:15:00"); +```js +var Noel95 = new Date("December 25, 1995 23:15:00"); var jour = Noel95.getDate(); console.log(jour); // 25 -</pre> - -<h2 id="Spécifications">Spécifications</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('ESDraft', '#sec-date.prototype.getdate', 'Date.prototype.getDate')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getdate', 'Date.prototype.getDate')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.14', 'Date.prototype.getDate')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.1.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getDate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> - <li>{{jsxref("Date.prototype.getUTCDay()")}}</li> - <li>{{jsxref("Date.prototype.setDate()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ESDraft', '#sec-date.prototype.getdate', 'Date.prototype.getDate')}} | {{Spec2('ESDraft')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getdate', 'Date.prototype.getDate')}} | {{Spec2('ES6')}} | | +| {{SpecName('ES5.1', '#sec-15.9.5.14', 'Date.prototype.getDate')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.1. | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getDate")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCDate()")}} +- {{jsxref("Date.prototype.getUTCDay()")}} +- {{jsxref("Date.prototype.setDate()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getday/index.md b/files/fr/web/javascript/reference/global_objects/date/getday/index.md index 0c4c3d23be..343fc41fcc 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getday/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getday/index.md @@ -10,83 +10,58 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getDay original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getDay --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getDay()</code></strong> renvoie le jour de la semaine pour la date spécifiée selon l'heure locale (0 correspondant à dimanche). Pour obtenir le jour du mois, on utilisera {{jsxref("Date.prototype.getDate()")}}.</p> +La méthode **`getDay()`** renvoie le jour de la semaine pour la date spécifiée selon l'heure locale (0 correspondant à dimanche). Pour obtenir le jour du mois, on utilisera {{jsxref("Date.prototype.getDate()")}}. -<div>{{EmbedInteractiveExample("pages/js/date-getday.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getday.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.getDay()</pre> + dateObj.getDay() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier correspondant au jour de la semaine (0 correspondant à dimanche, 1 à lundi, 2 à mardi et ainsi de suite) de la date indiquée selon l'heure locale.</p> +Un entier correspondant au jour de la semaine (0 correspondant à dimanche, 1 à lundi, 2 à mardi et ainsi de suite) de la date indiquée selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getDay()">Utiliser <code>getDay()</code></h3> +### Utiliser `getDay()` -<p>La seconde instruction ci-dessous assigne la valeur 1 à <code>jourSemaine</code>, selon la valeur de l'objet <code>Date</code> <code>noel95</code>. Le 25 décembre 1995 est un lundi.</p> +La seconde instruction ci-dessous assigne la valeur 1 à `jourSemaine`, selon la valeur de l'objet `Date` `noel95`. Le 25 décembre 1995 est un lundi. -<pre class="brush: js">var noel95 = new Date("December 25, 1995 23:15:00"); +```js +var noel95 = new Date("December 25, 1995 23:15:00"); var jourSemaine = noel95.getDay(); console.log(jourSemaine); //1 -</pre> - -<div class="blockIndicator note"> -<p><strong>Note :</strong> Si besoin, on pourra obtenir le nom complet du jour (<code>"lundi"</code> par exemple) en utilisant la méthode {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} avec un paramètre <code>options</code>. Ce faisant, il est plus simple d'internationaliser un site ou une application :</p> - -<pre class="brush: js">var options = { weekday: 'long'}; -console.log(new Intl.DateTimeFormat('en-US', options).format(Xmas95)); -// Monday -console.log(new Intl.DateTimeFormat('de-DE', options).format(Xmas95)); -// Montag -</pre> -</div> - -<h2 id="Spécifications">Spécifications</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('ESDraft', '#sec-date.prototype.getday', 'Date.prototype.getDay')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getday', 'Date.prototype.getDay')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.16', 'Date.prototype.getDay')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.0.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getDay")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> - <li>{{jsxref("Date.prototype.getUTCDay()")}}</li> - <li>{{jsxref("Date.prototype.setDate()")}}</li> -</ul> +``` + +> **Note :** Si besoin, on pourra obtenir le nom complet du jour (`"lundi"` par exemple) en utilisant la méthode {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} avec un paramètre `options`. Ce faisant, il est plus simple d'internationaliser un site ou une application : +> +> ```js +> var options = { weekday: 'long'}; +> console.log(new Intl.DateTimeFormat('en-US', options).format(Xmas95)); +> // Monday +> console.log(new Intl.DateTimeFormat('de-DE', options).format(Xmas95)); +> // Montag +> ``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ESDraft', '#sec-date.prototype.getday', 'Date.prototype.getDay')}} | {{Spec2('ESDraft')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getday', 'Date.prototype.getDay')}} | {{Spec2('ES6')}} | | +| {{SpecName('ES5.1', '#sec-15.9.5.16', 'Date.prototype.getDay')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getDay")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCDate()")}} +- {{jsxref("Date.prototype.getUTCDay()")}} +- {{jsxref("Date.prototype.setDate()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getfullyear/index.md b/files/fr/web/javascript/reference/global_objects/date/getfullyear/index.md index 16d862b7e3..d3cf612ee7 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getfullyear/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getfullyear/index.md @@ -10,72 +10,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getFullYear original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getFullYear --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getFullYear()</strong></code> renvoie l'année de la date renseignée d'après l'heure locale.</p> +La méthode **`getFullYear()`** renvoie l'année de la date renseignée d'après l'heure locale. -<p>Cette méthode doit être utilisée à la place de {{jsxref("Date.prototype.getYear()", "getYear()")}}.</p> +Cette méthode doit être utilisée à la place de {{jsxref("Date.prototype.getYear()", "getYear()")}}. -<div>{{EmbedInteractiveExample("pages/js/date-getfullyear.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getfullyear.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getFullYear()</pre> + dateObj.getFullYear() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier correspondant à l'année de la date selon l'heure locale.</p> +Un entier correspondant à l'année de la date selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getFullYear()">Utiliser <code>getFullYear()</code></h3> +### Utiliser `getFullYear()` -<p>L'exemple qui suit assigne la valeur à quatre chiffres de l'année courante à la variable <code>année</code>.</p> +L'exemple qui suit assigne la valeur à quatre chiffres de l'année courante à la variable `année`. -<pre class="brush: js">var aujd = new Date(); +```js +var aujd = new Date(); var année = aujd.getFullYear(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.10', 'Date.prototype.getFullYear')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getfullyear', 'Date.prototype.getFullYear')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getfullyear', 'Date.prototype.getFullYear')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getFullYear")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> - <li>{{jsxref("Date.prototype.setFullYear()")}}</li> - <li>{{jsxref("Date.prototype.getYear()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.10', 'Date.prototype.getFullYear')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getfullyear', 'Date.prototype.getFullYear')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getfullyear', 'Date.prototype.getFullYear')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getFullYear")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCFullYear()")}} +- {{jsxref("Date.prototype.setFullYear()")}} +- {{jsxref("Date.prototype.getYear()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/gethours/index.md b/files/fr/web/javascript/reference/global_objects/date/gethours/index.md index b0a5765a38..502652786f 100644 --- a/files/fr/web/javascript/reference/global_objects/date/gethours/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/gethours/index.md @@ -10,71 +10,47 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getHours original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getHours --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getHours()</strong></code> renvoie l'heure pour la date renseignée, d'après l'heure locale.</p> +La méthode **`getHours()`** renvoie l'heure pour la date renseignée, d'après l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-gethours.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-gethours.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.getHours()</pre> + dateObj.getHours() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier, compris entre 0 et 23 qui indique l'heure de la date indiquée selon l'heure locale.</p> +Un entier, compris entre 0 et 23 qui indique l'heure de la date indiquée selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getHours()">Utiliser <code>getHours()</code></h3> +### Utiliser `getHours()` -<p>La seconde instruction ci-dessous assigne la valeur 23 à la variable <code>heure</code>, selon la valeur de l'objet {{jsxref("Date")}} <code>noel95</code>.</p> +La seconde instruction ci-dessous assigne la valeur 23 à la variable `heure`, selon la valeur de l'objet {{jsxref("Date")}} `noel95`. -<pre class="brush: js">var noel95 = new Date("December 25, 1995 23:15:00"); +```js +var noel95 = new Date("December 25, 1995 23:15:00"); var heure = noel95.getHours(); console.log(heure); //23 -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.18', 'Date.prototype.getHours')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.gethours', 'Date.prototype.getHours')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.gethours', 'Date.prototype.getHours')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getHours")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCHours()")}}</li> - <li>{{jsxref("Date.prototype.setHours()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.18', 'Date.prototype.getHours')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.gethours', 'Date.prototype.getHours')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.gethours', 'Date.prototype.getHours')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getHours")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCHours()")}} +- {{jsxref("Date.prototype.setHours()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getmilliseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/getmilliseconds/index.md index d2befc401d..5476fccef0 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getmilliseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getmilliseconds/index.md @@ -10,69 +10,45 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getMilliseconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getMilliseconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getMilliseconds()</strong></code> renvoie les millièmes de secondes de la date renseignée d'après l'heure locale.</p> +La méthode **`getMilliseconds()`** renvoie les millièmes de secondes de la date renseignée d'après l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-getmilliseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getmilliseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.getMilliseconds()</pre> + dateObj.getMilliseconds() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un nombre entre 0 et 999 indiquant le nombre de millisecondes pour la date indiquée, selon l'heure locale.</p> +Un nombre entre 0 et 999 indiquant le nombre de millisecondes pour la date indiquée, selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getMilliseconds()">Utiliser <code>getMilliseconds()</code></h3> +### Utiliser `getMilliseconds()` -<p>L'exemple suivant assigne la partie des millièmes de secondes de l'heure courante à la variable <code>ms</code>.</p> +L'exemple suivant assigne la partie des millièmes de secondes de l'heure courante à la variable `ms`. -<pre class="brush: js">var aujd = new Date(); +```js +var aujd = new Date(); var ms = aujd.getMilliseconds(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.24', 'Date.prototype.getMilliseconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getmilliseconds', 'Date.prototype.getMilliseconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getmilliseconds', 'Date.prototype.getMilliseconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getMilliseconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</li> - <li>{{jsxref("Date.prototype.setMilliseconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.24', 'Date.prototype.getMilliseconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getmilliseconds', 'Date.prototype.getMilliseconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getmilliseconds', 'Date.prototype.getMilliseconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getMilliseconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCMilliseconds()")}} +- {{jsxref("Date.prototype.setMilliseconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getminutes/index.md b/files/fr/web/javascript/reference/global_objects/date/getminutes/index.md index 5a866eef11..f7a9657f90 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getminutes/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getminutes/index.md @@ -10,71 +10,47 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getMinutes original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getMinutes --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getMinutes()</code></strong> renvoie les minutes pour la date renseignée d'après l'heure locale.</p> +La méthode **`getMinutes()`** renvoie les minutes pour la date renseignée d'après l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-getminutes.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getminutes.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.getMinutes()</pre> + dateObj.getMinutes() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur renvoyée par <code>getMinutes</code> est un entier entre 0 et 59 représentant le nombre de minutes pour la date indiquée, selon l'heure locale.</p> +La valeur renvoyée par `getMinutes` est un entier entre 0 et 59 représentant le nombre de minutes pour la date indiquée, selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getMinutes()">Utiliser <code>getMinutes()</code></h3> +### Utiliser `getMinutes()` -<p>La seconde instruction ci-dessous assigne la valeur 15 à la variable <code>minutes</code>, selon la valeur de l'objet {{jsxref("Date")}} <code>noel95</code>.</p> +La seconde instruction ci-dessous assigne la valeur 15 à la variable `minutes`, selon la valeur de l'objet {{jsxref("Date")}} `noel95`. -<pre class="brush: js">var noel95 = new Date("December 25, 1995 23:15:00"); +```js +var noel95 = new Date("December 25, 1995 23:15:00"); var minutes = noel95.getMinutes(); console.log(minutes); //15 -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.20', 'Date.prototype.getMinutes')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getminutes', 'Date.prototype.getMinutes')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getminutes', 'Date.prototype.getMinutes')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getMinutes")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCMinutes()")}}</li> - <li>{{jsxref("Date.prototype.setMinutes()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.20', 'Date.prototype.getMinutes')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getminutes', 'Date.prototype.getMinutes')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getminutes', 'Date.prototype.getMinutes')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getMinutes")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCMinutes()")}} +- {{jsxref("Date.prototype.setMinutes()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getmonth/index.md b/files/fr/web/javascript/reference/global_objects/date/getmonth/index.md index e51d1ccb64..2f3cdd1c3f 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getmonth/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getmonth/index.md @@ -10,82 +10,57 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getMonth original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getMonth --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getMonth()</strong></code> retourne le mois de la date renseignée d'après l'heure locale. La numérotation démarre à 0 (c'est-à-dire que 0 correspond au premier mois de l'année).</p> +La méthode **`getMonth()`** retourne le mois de la date renseignée d'après l'heure locale. La numérotation démarre à 0 (c'est-à-dire que 0 correspond au premier mois de l'année). -<div>{{EmbedInteractiveExample("pages/js/date-getmonth.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getmonth.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>dateObj.g</em>etMonth()</pre> + dateObj.getMonth() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 0 et 11 selon le mois de la date indiquée et d'après l'heure locale (0 correspond à janvier, 1 à février, et ainsi de suite).</p> +Un entier entre 0 et 11 selon le mois de la date indiquée et d'après l'heure locale (0 correspond à janvier, 1 à février, et ainsi de suite). -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getMonth()">Utiliser <code>getMonth()</code></h3> +### Utiliser `getMonth()` -<p>La seconde instruction ci-dessous assigne la valeur 11 à la variable <code>mois</code>, d'après la valeur de l'objet {{jsxref("Date")}} <code>noel95</code>.</p> +La seconde instruction ci-dessous assigne la valeur 11 à la variable `mois`, d'après la valeur de l'objet {{jsxref("Date")}} `noel95`. -<pre class="brush: js">var noel95 = new Date("December 25, 1995 23:15:00"); +```js +var noel95 = new Date("December 25, 1995 23:15:00"); var mois = noel95.getMonth(); console.log(mois); //11 -</pre> - -<div class="blockIndicator note"> -<p><strong>Note :</strong> Si besoin, on pourra récupérer le nom complet du mois (<code>"Janvier"</code> par exemple) en utilisant <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat">Intl.DateTimeFormat()</a></code> avec un paramètre <code>options</code>. En utilisant cette méthode, il est plus simple d'internationaliser le site ou l'application :</p> - -<pre class="brush: js">var options = { month: 'long'}; -console.log(new Intl.DateTimeFormat('en-US', options).format(noel95)); -// December -console.log(new Intl.DateTimeFormat('de-DE', options).format(noel95)); -// Dezember -</pre> -</div> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.12', 'Date.prototype.getMonth')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getmonth', 'Date.prototype.getMonth')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getmonth', 'Date.prototype.getMonth')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getMonth")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCMonth()")}}</li> - <li>{{jsxref("Date.prototype.setMonth()")}}</li> -</ul> +``` + +> **Note :** Si besoin, on pourra récupérer le nom complet du mois (`"Janvier"` par exemple) en utilisant [`Intl.DateTimeFormat()`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat) avec un paramètre `options`. En utilisant cette méthode, il est plus simple d'internationaliser le site ou l'application : +> +> ```js +> var options = { month: 'long'}; +> console.log(new Intl.DateTimeFormat('en-US', options).format(noel95)); +> // December +> console.log(new Intl.DateTimeFormat('de-DE', options).format(noel95)); +> // Dezember +> ``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.12', 'Date.prototype.getMonth')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getmonth', 'Date.prototype.getMonth')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getmonth', 'Date.prototype.getMonth')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getMonth")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCMonth()")}} +- {{jsxref("Date.prototype.setMonth()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/getseconds/index.md index 32c91e493c..ddbd49d19a 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getseconds/index.md @@ -10,71 +10,47 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getSeconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getSeconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getSeconds()</code></strong> renvoie les secondes pour la date renseignée d'après l'heure locale.</p> +La méthode **`getSeconds()`** renvoie les secondes pour la date renseignée d'après l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-getseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getSeconds()</pre> + dateObj.getSeconds() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur renvoyée par <code>getSeconds()</code> est un entier entre 0 et 59 correspondant au nombre de secondes pour la date donnée selon l'heure locale.</p> +La valeur renvoyée par `getSeconds()` est un entier entre 0 et 59 correspondant au nombre de secondes pour la date donnée selon l'heure locale. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getSeconds()">Utiliser <code>getSeconds()</code></h3> +### Utiliser `getSeconds()` -<p>La seconde instruction ci-dessous assigne la valeur 30 à la variable <code>secondes</code>, selon la valeur de l'objet {{jsxref("Date")}} <code>noel95</code>.</p> +La seconde instruction ci-dessous assigne la valeur 30 à la variable `secondes`, selon la valeur de l'objet {{jsxref("Date")}} `noel95`. -<pre class="brush: js">var noel95 = new Date("December 25, 1995 23:15:30"); +```js +var noel95 = new Date("December 25, 1995 23:15:30"); var secondes = noel95.getSeconds(); console.log(secondes); //30 -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.22', 'Date.prototype.getSeconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getseconds', 'Date.prototype.getSeconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getseconds', 'Date.prototype.getSeconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getSeconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCSeconds()")}}</li> - <li>{{jsxref("Date.prototype.setSeconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.22', 'Date.prototype.getSeconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getseconds', 'Date.prototype.getSeconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getseconds', 'Date.prototype.getSeconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getSeconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCSeconds()")}} +- {{jsxref("Date.prototype.setSeconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/gettime/index.md b/files/fr/web/javascript/reference/global_objects/date/gettime/index.md index 86ceaedccd..9c2ac28bca 100644 --- a/files/fr/web/javascript/reference/global_objects/date/gettime/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/gettime/index.md @@ -10,53 +10,56 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getTime original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getTime --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getTime()</code></strong> renvoie la valeur numérique correspondant au temps pour la date renseignée, d'après le temps universel (c'est-à-dire relative à UTC, une mesure donnée par <code>getTime()</code> sera indépendante du fuseau horaire sur lequel on se trouve). Cette valeur numérique est le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC.</p> +La méthode **`getTime()`** renvoie la valeur numérique correspondant au temps pour la date renseignée, d'après le temps universel (c'est-à-dire relative à UTC, une mesure donnée par `getTime()` sera indépendante du fuseau horaire sur lequel on se trouve). Cette valeur numérique est le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC. -<p>Vous pouvez utiliser cette méthode pour vous affecter une date et un temps à une autre instance de <code>Date</code>. Cette méthode est fonctionnellement équivalente à la méthode {{jsxref("Date.valueof", "valueOf()")}}.</p> +Vous pouvez utiliser cette méthode pour vous affecter une date et un temps à une autre instance de `Date`. Cette méthode est fonctionnellement équivalente à la méthode {{jsxref("Date.valueof", "valueOf()")}}. -<div>{{EmbedInteractiveExample("pages/js/date-gettime.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-gettime.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getTime()</pre> + dateObj.getTime() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur renvoyée par la méthode <code>getTime()</code> est le nombre de millièmes de secondes entre le 1 janvier 1970 à 00:00:00 UTC et la date indiquée.</p> +La valeur renvoyée par la méthode `getTime()` est le nombre de millièmes de secondes entre le 1 janvier 1970 à 00:00:00 UTC et la date indiquée. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getTime()">Utiliser <code>getTime()</code></h3> +### Utiliser `getTime()` -<p>L'exemple qui suit assigne la valeur de <code>anniversaire</code> à <code>copie</code> :</p> +L'exemple qui suit assigne la valeur de `anniversaire` à `copie` : -<pre class="brush: js">var anniversaire = new Date(1994 , 11, 10); // 10 décembre 1994 +```js +var anniversaire = new Date(1994 , 11, 10); // 10 décembre 1994 var copie = new Date(); copie.setTime(anniversaire.getTime()); -</pre> +``` -<h3 id="Mesurer_un_temps_d'exécution">Mesurer un temps d'exécution</h3> +### Mesurer un temps d'exécution -<p>Effectuer une soustration entre deux appels à <code>getTime()</code> donne la durée écoulée entre ces appels. On peut donc utiliser cette méthode afin de connaître la durée d'exécution de certaines opérations (voir également la méthode {{jsxref("Date.now()")}} qui peut permettre d'éviter d'instancier des objets intermédiaires).</p> +Effectuer une soustration entre deux appels à `getTime()` donne la durée écoulée entre ces appels. On peut donc utiliser cette méthode afin de connaître la durée d'exécution de certaines opérations (voir également la méthode {{jsxref("Date.now()")}} qui peut permettre d'éviter d'instancier des objets intermédiaires). -<pre class="brush: js">var fin, début; +```js +var fin, début; début = new Date(); -for (var i = 0; i < 1000; i++) { +for (var i = 0; i < 1000; i++) { Math.sqrt(i); } fin = new Date(); console.log('Durée de cette opération : ' + (fin.getTime() - début.getTime()) + ' msec'); -</pre> +``` -<h2 id="Précision_temporelle_réduite">Précision temporelle réduite</h2> +## Précision temporelle réduite -<p>Afin de protéger contre les attaques de minutage et d'identification, la précision de <code>new Date().getTime()</code> peut être arrondie en fonction des paramètres du navigateur. Pour Firefox, la préférence <code>privacy.reduceTimerPrecision</code> est activée par défaut et vaut, par défaut 20µs pour Firefox 59 et 2ms pour Firefox 60.</p> +Afin de protéger contre les attaques de minutage et d'identification, la précision de `new Date().getTime()` peut être arrondie en fonction des paramètres du navigateur. Pour Firefox, la préférence `privacy.reduceTimerPrecision` est activée par défaut et vaut, par défaut 20µs pour Firefox 59 et 2ms pour Firefox 60. -<pre class="brush: js">// Précision temporelle réduite (2ms) pour Firefox 60 +```js +// Précision temporelle réduite (2ms) pour Firefox 60 new Date().getTime(); // 1519211809934 // 1519211810362 @@ -70,50 +73,25 @@ new Date().getTime(); // 1519129858900 // 1519129864400 // ... -</pre> - -<p>Pour Firefox, il est également possible d'activer <code>privacy.resistFingerprinting</code> auquel cas la précision sera 100ms ou la valeur de <code>privacy.resistFingerprinting.reduceTimerPrecision.microseconds</code> selon laquelle est plus grande.</p> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.9', 'Date.prototype.getTime')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getTime")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.setTime()")}}</li> - <li>{{jsxref("Date.prototype.valueOf()")}}</li> - <li>{{jsxref("Date.prototype.now()")}}</li> -</ul> +``` + +Pour Firefox, il est également possible d'activer `privacy.resistFingerprinting` auquel cas la précision sera 100ms ou la valeur de `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` selon laquelle est plus grande. + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.9', 'Date.prototype.getTime')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getTime")}} + +## Voir aussi + +- {{jsxref("Date.prototype.setTime()")}} +- {{jsxref("Date.prototype.valueOf()")}} +- {{jsxref("Date.prototype.now()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/gettimezoneoffset/index.md b/files/fr/web/javascript/reference/global_objects/date/gettimezoneoffset/index.md index a4a46512c1..a313ba77c9 100644 --- a/files/fr/web/javascript/reference/global_objects/date/gettimezoneoffset/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/gettimezoneoffset/index.md @@ -10,27 +10,28 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getTimezoneOffset --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getTimezoneOffset()</strong></code> retourne la différence en minutes entre le fuseau horaire UTC, et celui de l'heure locale.</p> +La méthode **`getTimezoneOffset()`** retourne la différence en minutes entre le fuseau horaire UTC, et celui de l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-gettimezoneoffset.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-gettimezoneoffset.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getTimezoneOffset()</pre> + dateObj.getTimezoneOffset() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur retournée est la différence, exprimée en minutes, entre les fuseaux horaires UTC et celui de l'heure locale. Cette différence est positive si le fuseau horaire local est en retard par rapport à UTC, et négative s'il est en avance.</p> +La valeur retournée est la différence, exprimée en minutes, entre les fuseaux horaires UTC et celui de l'heure locale. Cette différence est positive si le fuseau horaire local est en retard par rapport à UTC, et négative s'il est en avance. -<p>Par exemple, si votre fuseau horaire est UTC+10 (Australian Eastern Standard Time, Vladivostok, Chamorro), la valeur retournée sera -600. L'heure d'été (DST pour <em>daylight saving time</em> en anglais) empêche cette valeur d'être une constante.</p> +Par exemple, si votre fuseau horaire est UTC+10 (Australian Eastern Standard Time, Vladivostok, Chamorro), la valeur retournée sera -600. L'heure d'été (DST pour _daylight saving time_ en anglais) empêche cette valeur d'être une constante. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getTimezoneOffset()">Utiliser <code>getTimezoneOffset()</code></h3> +### Utiliser `getTimezoneOffset()` -<pre class="brush:js">var x = new Date(); +```js +var x = new Date(); var differenceFuseauxEnHeures = x.getTimezoneOffset() / 60; // -2 @@ -40,40 +41,17 @@ var differenceFuseauxEnHeures = x.getTimezoneOffset() / 60; // avec 4 (et pas 5) var travail = new Date(2017, 4, 1); var decalage = travail.getTimezoneOffset() / 60; -</pre> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.26', 'Date.prototype.getTimezoneOffset')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.26', 'Date.prototype.getTimezoneOffset')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.Date.getTimezoneOffset")}}</p> +{{Compat("javascript.builtins.Date.getTimezoneOffset")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcdate/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcdate/index.md index 0d4fa90f29..5f062ea4fb 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcdate/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcdate/index.md @@ -10,70 +10,46 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCDate original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCDate --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCDate()</code></strong> renvoie le jour du mois pour la date renseignée d'après UTC.</p> +La méthode **`getUTCDate()`** renvoie le jour du mois pour la date renseignée d'après UTC. -<div>{{EmbedInteractiveExample("pages/js/date-getutcdate.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcdate.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.getUTCDate()</pre> + dateObj.getUTCDate() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur renseignée par <code>getUTCDate()</code> est un entier entre 1 et 31 pour le jour du mois de la date indiquée selon le temps universel.</p> +La valeur renseignée par `getUTCDate()` est un entier entre 1 et 31 pour le jour du mois de la date indiquée selon le temps universel. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCDate()">Utiliser <code>getUTCDate()</code></h3> +### Utiliser `getUTCDate()` -<p>L'exemple suivant assigne le jour du mois pour la date actuelle, à la variable <code>jour</code>.</p> +L'exemple suivant assigne le jour du mois pour la date actuelle, à la variable `jour`. -<pre class="brush:js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var jour = aujourdhui.getUTCDate(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.15', 'Date.prototype.getUTCDate')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcdate', 'Date.prototype.getUTCDate')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcdate', 'Date.prototype.getUTCDate')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCDate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getDate()")}}</li> - <li>{{jsxref("Date.prototype.getUTCDay()")}}</li> - <li>{{jsxref("Date.prototype.setUTCDate()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.15', 'Date.prototype.getUTCDate')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcdate', 'Date.prototype.getUTCDate')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcdate', 'Date.prototype.getUTCDate')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCDate")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getDate()")}} +- {{jsxref("Date.prototype.getUTCDay()")}} +- {{jsxref("Date.prototype.setUTCDate()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcday/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcday/index.md index db8134b5ce..6fe7f094b9 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcday/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcday/index.md @@ -10,70 +10,46 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCDay original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCDay --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCDay()</code></strong> renvoie le jour de la semaine pour la date renseignée d'après UTC. La numérotation commence à 0, et dimanche est considéré comme le premier jour de la semaine.</p> +La méthode **`getUTCDay()`** renvoie le jour de la semaine pour la date renseignée d'après UTC. La numérotation commence à 0, et dimanche est considéré comme le premier jour de la semaine. -<div>{{EmbedInteractiveExample("pages/js/date-getutcday.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcday.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCDay()</pre> + dateObj.getUTCDay() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur renvoyée par <code>getUTCDay()</code> est un entier correspondant au jour de la semaine de la date indiquée selon le temps universel (0 pour dimanche, 1 pour lundi, 2 pour mardi, et ainsi de suite).</p> +La valeur renvoyée par `getUTCDay()` est un entier correspondant au jour de la semaine de la date indiquée selon le temps universel (0 pour dimanche, 1 pour lundi, 2 pour mardi, et ainsi de suite). -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCDay()">Utiliser <code>getUTCDay()</code></h3> +### Utiliser `getUTCDay()` -<p>L'exemple suivant assigne le jour de la semaine de la date actuelle à la variable <code>jourSemaine</code>.</p> +L'exemple suivant assigne le jour de la semaine de la date actuelle à la variable `jourSemaine`. -<pre class="brush: js">var aujourdhui = new Date() +```js +var aujourdhui = new Date() var jourSemaine = aujourdhui.getUTCDay() -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.17', 'Date.prototype.getUTCDay')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcday', 'Date.prototype.getUTCDay')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcday', 'Date.prototype.getUTCDay')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCDay")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> - <li>{{jsxref("Date.prototype.getDay()")}}</li> - <li>{{jsxref("Date.prototype.setUTCDate()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.17', 'Date.prototype.getUTCDay')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcday', 'Date.prototype.getUTCDay')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcday', 'Date.prototype.getUTCDay')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCDay")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCDate()")}} +- {{jsxref("Date.prototype.getDay()")}} +- {{jsxref("Date.prototype.setUTCDate()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcfullyear/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcfullyear/index.md index c2c81cc8ab..a481accedf 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcfullyear/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcfullyear/index.md @@ -10,68 +10,45 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCFullYear original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCFullYear --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>getUTCFullYear()</strong></code> renvoie l'année de la date renseignée, d'après UTC.</p> +La méthode **`getUTCFullYear()`** renvoie l'année de la date renseignée, d'après UTC. -<div>{{EmbedInteractiveExample("pages/js/date-getutcfullyear.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcfullyear.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCFullYear()</pre> + dateObj.getUTCFullYear() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>La valeur renvoyée par <code>getUTCFullYear</code><code>()</code> est un nombre correspondant à l'année de la date indiquée selon le temps universel. Pour les dates entre les années 1000 et 9999, <code>getUTCFullYear</code><code>()</code> renvoie un nombre à quatre chiffres, par exemple 1995.</p> +La valeur renvoyée par ` getUTCFullYear``() ` est un nombre correspondant à l'année de la date indiquée selon le temps universel. Pour les dates entre les années 1000 et 9999, ` getUTCFullYear``() ` renvoie un nombre à quatre chiffres, par exemple 1995. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCFullYear()">Utiliser <code>getUTCFullYear()</code></h3> +### Utiliser `getUTCFullYear()` -<p>L'exemple suivant assigne une valeur à 4 chiffres, l'année courante, à la variable <code>annee</code>.</p> +L'exemple suivant assigne une valeur à 4 chiffres, l'année courante, à la variable `annee`. -<pre class="brush:js">var aujourdhui = new Date(); -var annee = aujourdhui.getUTCFullYear();</pre> +```js +var aujourdhui = new Date(); +var annee = aujourdhui.getUTCFullYear(); +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<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-15.9.5.11', 'Date.prototype.getUTCFullYear')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcfullyear', 'Date.prototype.getUTCFullYear')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcfullyear', 'Date.prototype.getUTCFullYear')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.11', 'Date.prototype.getUTCFullYear')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcfullyear', 'Date.prototype.getUTCFullYear')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcfullyear', 'Date.prototype.getUTCFullYear')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.Date.getUTCFullYear")}}</p> +{{Compat("javascript.builtins.Date.getUTCFullYear")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("Date.prototype.getFullYear()")}}</li> - <li>{{jsxref("Date.prototype.setFullYear()")}}</li> -</ul> +- {{jsxref("Date.prototype.getFullYear()")}} +- {{jsxref("Date.prototype.setFullYear()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutchours/index.md b/files/fr/web/javascript/reference/global_objects/date/getutchours/index.md index 225b1d3721..186c88055b 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutchours/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutchours/index.md @@ -10,69 +10,45 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCHours original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCHours --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCHours()</code></strong> renvoie les heures de la date renseignée, d'après UTC.</p> +La méthode **`getUTCHours()`** renvoie les heures de la date renseignée, d'après UTC. -<div>{{EmbedInteractiveExample("pages/js/date-getutchours.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutchours.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCHours()</pre> + dateObj.getUTCHours() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 0 et 23 correspondant à l'heure de la date indiquée selon le temps universel.</p> +Un entier entre 0 et 23 correspondant à l'heure de la date indiquée selon le temps universel. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCHours()">Utiliser <code>getUTCHours()</code></h3> +### Utiliser `getUTCHours()` -<p>L'exemple suivant assigne les heures de la date actuelle à la variable <code>heures</code>.</p> +L'exemple suivant assigne les heures de la date actuelle à la variable `heures`. -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var heures = aujourdhui.getUTCHours(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.19', 'Date.prototype.getUTCHours')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutchours', 'Date.prototype.getUTCHours')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutchours', 'Date.prototype.getUTCHours')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCHours")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getHours()")}}</li> - <li>{{jsxref("Date.prototype.setUTCHours()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.19', 'Date.prototype.getUTCHours')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutchours', 'Date.prototype.getUTCHours')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutchours', 'Date.prototype.getUTCHours')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCHours")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getHours()")}} +- {{jsxref("Date.prototype.setUTCHours()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcmilliseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcmilliseconds/index.md index 898edb560b..ba7b30ec9c 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcmilliseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcmilliseconds/index.md @@ -10,73 +10,47 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCMilliseconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCMilliseconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCMilliseconds()</code></strong> renvoie les millièmes de secondes pour la date renseignée selon UTC.</p> +La méthode **`getUTCMilliseconds()`** renvoie les millièmes de secondes pour la date renseignée selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-getutcmilliseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcmilliseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCMilliseconds()</pre> + dateObj.getUTCMilliseconds() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 0 et 999 correspondant au nombre de millisecondes pour la date indiquée, selon le temps universel.</p> +Un entier entre 0 et 999 correspondant au nombre de millisecondes pour la date indiquée, selon le temps universel. -<div class="blockIndicator note"> -<p><strong>Note :</strong> Le résultat de cette méthode n'est pas le temps "Epoch". Si on veut obtenir le nombre de millisecondes depuis le premier janvier 1970, on utilisera la méthode {{jsxref("Date.prototype.getTime()")}}.</p> -</div> +> **Note :** Le résultat de cette méthode n'est pas le temps "Epoch". Si on veut obtenir le nombre de millisecondes depuis le premier janvier 1970, on utilisera la méthode {{jsxref("Date.prototype.getTime()")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCMilliseconds()">Utiliser <code>getUTCMilliseconds()</code></h3> +### Utiliser `getUTCMilliseconds()` -<p>L'exemple suivant assigne les millièmes de secondes pour la date actuelle à la variable <code>ms</code>.</p> +L'exemple suivant assigne les millièmes de secondes pour la date actuelle à la variable `ms`. -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var ms = aujourdhui.getUTCMilliseconds(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.25', 'Date.prototype.getUTCMilliseconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcmilliseconds', 'Date.prototype.getUTCMilliseconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcmilliseconds', 'Date.prototype.getUTCMilliseconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCMilliseconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getMilliseconds()")}}</li> - <li>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.25', 'Date.prototype.getUTCMilliseconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcmilliseconds', 'Date.prototype.getUTCMilliseconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcmilliseconds', 'Date.prototype.getUTCMilliseconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCMilliseconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getMilliseconds()")}} +- {{jsxref("Date.prototype.setUTCMilliseconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcminutes/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcminutes/index.md index 53b7aec489..5cda61f0a0 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcminutes/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcminutes/index.md @@ -10,69 +10,45 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCMinutes original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCMinutes --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCMinutes()</code></strong> renvoie les minutes de la date renseignée, d'après UTC.</p> +La méthode **`getUTCMinutes()`** renvoie les minutes de la date renseignée, d'après UTC. -<div>{{EmbedInteractiveExample("pages/js/date-getutcminutes.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcminutes.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCMinutes()</pre> + dateObj.getUTCMinutes() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 0 et 59 correspondant au nombre de minutes pour la date indiquée selon le temps universel.</p> +Un entier entre 0 et 59 correspondant au nombre de minutes pour la date indiquée selon le temps universel. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCMinutes">Utiliser <code>getUTCMinutes</code></h3> +### Utiliser `getUTCMinutes` -<p>L'exemple suivant assigne les minutes de la date actuelle à la variable <code>minutes</code>.</p> +L'exemple suivant assigne les minutes de la date actuelle à la variable `minutes`. -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var minutes = aujourdhui.getUTCMinutes(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.21', 'Date.prototype.getUTCMinutes')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcminutes', 'Date.prototype.getUTCMinutes')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcminutes', 'Date.prototype.getUTCMinutes')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCMinutes")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getMinutes()")}}</li> - <li>{{jsxref("Date.prototype.setUTCMinutes()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.21', 'Date.prototype.getUTCMinutes')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcminutes', 'Date.prototype.getUTCMinutes')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcminutes', 'Date.prototype.getUTCMinutes')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCMinutes")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getMinutes()")}} +- {{jsxref("Date.prototype.setUTCMinutes()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcmonth/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcmonth/index.md index 5f8ce36dca..562f934ba4 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcmonth/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcmonth/index.md @@ -10,69 +10,45 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCMonth original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCMonth --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCMonth()</code></strong> renvoie le mois de la date renseignée, d'après UTC. La numérotation des mois commence à 0 pour le premier mois de l'année.</p> +La méthode **`getUTCMonth()`** renvoie le mois de la date renseignée, d'après UTC. La numérotation des mois commence à 0 pour le premier mois de l'année. -<div>{{EmbedInteractiveExample("pages/js/date-getutcmonth.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcmonth.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCMonth()</pre> + dateObj.getUTCMonth() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 0 et 11 correspondant au mois dans l'année de la date indiquée selon le temps universel (0 pour janvier, 1 pour février, 2 pour mars, et ainsi de suite…).</p> +Un entier entre 0 et 11 correspondant au mois dans l'année de la date indiquée selon le temps universel (0 pour janvier, 1 pour février, 2 pour mars, et ainsi de suite…). -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCMonth()">Utiliser <code>getUTCMonth()</code></h3> +### Utiliser `getUTCMonth()` -<p>L'exemple suivant assigne le mois de la date actuelle à la variable <code>mois</code>.</p> +L'exemple suivant assigne le mois de la date actuelle à la variable `mois`. -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var mois = aujourdhui.getUTCMonth(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.13', 'Date.prototype.getUTCMonth')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcmonth', 'Date.prototype.getUTCMonth')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcmonth', 'Date.prototype.getUTCMonth')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCMonth")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getMonth()")}}</li> - <li>{{jsxref("Date.prototype.setUTCMonth()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.13', 'Date.prototype.getUTCMonth')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcmonth', 'Date.prototype.getUTCMonth')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcmonth', 'Date.prototype.getUTCMonth')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCMonth")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getMonth()")}} +- {{jsxref("Date.prototype.setUTCMonth()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/getutcseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/getutcseconds/index.md index 8f65ada277..10b092970d 100644 --- a/files/fr/web/javascript/reference/global_objects/date/getutcseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/getutcseconds/index.md @@ -10,69 +10,45 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCSeconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/getUTCSeconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>getUTCSeconds()</code></strong> renvoie les secondes de la date renseignée, d'après UTC.</p> +La méthode **`getUTCSeconds()`** renvoie les secondes de la date renseignée, d'après UTC. -<div>{{EmbedInteractiveExample("pages/js/date-getutcseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-getutcseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getUTCSeconds()</pre> + dateObj.getUTCSeconds() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un entier entre 0 et 59 correspondant au nombre de secondes écoulées pour la date indiquée selon le temps universel.</p> +Un entier entre 0 et 59 correspondant au nombre de secondes écoulées pour la date indiquée selon le temps universel. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_getUTCSeconds()">Utiliser <code>getUTCSeconds()</code></h3> +### Utiliser `getUTCSeconds()` -<p>L'exemple suivant assigne les secondes de la date actuelle à la variable <code>secondes</code>.</p> +L'exemple suivant assigne les secondes de la date actuelle à la variable `secondes`. -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var secondes = aujourdhui.getUTCSeconds(); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.23', 'Date.prototype.getUTCSeconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.getutcseconds', 'Date.prototype.getUTCSeconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcseconds', 'Date.prototype.getUTCSeconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.getUTCSeconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getSeconds()")}}</li> - <li>{{jsxref("Date.prototype.setUTCSeconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.23', 'Date.prototype.getUTCSeconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.getutcseconds', 'Date.prototype.getUTCSeconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.getutcseconds', 'Date.prototype.getUTCSeconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.getUTCSeconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getSeconds()")}} +- {{jsxref("Date.prototype.setUTCSeconds()")}} 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 --- -<div>{{JSRef}} {{Deprecated_header}}</div> +{{JSRef}} {{Deprecated_header}} -<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> +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")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.getYear()</pre> + dateObj.getYear() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un nombre représentant l'année de la date indiquée, selon l'heure locale, auquel on a soustrait 1900.</p> +Un nombre représentant l'année de la date indiquée, selon l'heure locale, auquel on a soustrait 1900. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>getYear()</code> renvoie l'année moins 1900 ; par conséquent :</p> +La méthode `getYear()` renvoie l'année moins 1900 ; par conséquent : -<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> +- 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. -<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> +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. -<h2 id="Rétrocompatibilité">Rétrocompatibilité</h2> +## Rétrocompatibilité -<h3 id="Comportement_dans_JavaScript_1.2_et_versions_antérieures">Comportement dans JavaScript 1.2 et versions antérieures</h3> +### Comportement dans JavaScript 1.2 et versions antérieures -<p>La méthode <code>getYear()</code> renvoyait soit une année en deux chiffres, soit une année en quatre chiffres :</p> +La méthode `getYear()` renvoyait soit une année en deux chiffres, soit une année en quatre chiffres : -<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> +- 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. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Années_entre_1900_et_1999">Années entre 1900 et 1999</h3> +### Années entre 1900 et 1999 -<p>La seconde instruction assigne la valeur 95 à la variable <code>annee</code>.</p> +La seconde instruction assigne la valeur 95 à la variable `annee`. -<pre class="brush: js">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 -</pre> +``` -<h3 id="Années_après_1999">Années après 1999</h3> +### Années après 1999 -<p>La seconde instruction assigne la valeur 100 à la variable <code>annee</code>.</p> +La seconde instruction assigne la valeur 100 à la variable `annee`. -<pre class="brush: js">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 -</pre> +``` -<h3 id="Années_avant_1900">Années avant 1900</h3> +### Années avant 1900 -<p>La seconde instruction assigne la valeur -100 à la variable <code>annee</code>.</p> +La seconde instruction assigne la valeur -100 à la variable `annee`. -<pre class="brush: js">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 -</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> +### Définition et lecture d'une année entre 1900 et 1999 -<p>La troisième instruction assigne la valeur 95 à la variable <code>annee</code>, représentant l'année 1995.</p> +La troisième instruction assigne la valeur 95 à la variable `annee`, représentant l'année 1995. -<pre class="brush: js">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 -</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>{{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> +``` + +## 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()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/index.md b/files/fr/web/javascript/reference/global_objects/date/index.md index d2ea76a64e..d5ed46eb1a 100644 --- a/files/fr/web/javascript/reference/global_objects/date/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/index.md @@ -8,205 +8,201 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date original_slug: Web/JavaScript/Reference/Objets_globaux/Date --- -<div>{{JSRef}}</div> - -<p>Les objets JavaScript <strong><code>Date</code></strong> représentent un instant donné sur l'axe du temps dans un format indépendant de la plateforme utilisée. Les objets <code>Date</code> contiennent un nombre (<code>Number</code>) qui représente le nombre de millisecondes écoulées depuis le premier janvier 1970 sur l'échelle <a href="https://fr.wikipedia.org/wiki/Temps_universel_coordonn%C3%A9">UTC</a>.</p> - -<div class="note"><p><strong>Note :</strong> TC39 travaille actuellement sur <a href="https://tc39.es/proposal-temporal/docs/index.html">Temporal</a>, une nouvelle API pour la gestion des dates, heures et données temporelles.<br> - Pour en savoir plus, consultez le <a href="https://blogs.igalia.com/compilers/2020/06/23/dates-and-times-in-javascript/">blog d'Igalia</a> et n'hésitez pas à répondre <a href="https://forms.gle/iL9iZg7Y9LvH41Nv8">au sondage</a>. Les retours concrets de développeurs web sont importants pour affiner cette API. Attention, elle n'est pas encore prête à être utilisée en production !</p> -</div> - -<h2 id="Description">Description</h2> - -<h3 id="Lepoch_ECMAScript">L'epoch ECMAScript</h3> - -<p>D'un point de vue technique, une date JavaScript correspond au nombre de millisecondes écoulées depuis le premier janvier 1970, minuit UTC. Cette date et cette heure sont les mêmes que <strong>l'<a href="https://fr.wikipedia.org/wiki/Epoch">epoch</a> UNIX</strong>, qui est l'instant de référence principalement utilisé pour manipuler les dates/heures dans les systèmes informatiques.</p> - -<div class="note"><p><strong>Note :</strong> Bien que les valeurs temporelles des objets dates soient relatives à UTC, certaines des méthodes simples pour obtenir les composantes d'une date/heure fonctionnent relativement au fuseau horaire du système.</p></div> - -<p>On notera également que la représentation maximale d'un objet <code>Date</code> n'est pas la même que le plus grand entier représentable en JavaScript (<code>Number.MAX_SAFE_INTEGER</code> vaut 9,007,199,254,740,991). En effet, ECMA-262 définit un maximum de ±100 000 000 (cent millions) jours relatifs au premier janvier 1970 UTC (ce qui correspond au 20 avril 271 821 avant notre ètre d'une part et au 13 septembre 275 760 de notre ère) pouvant être représentés par un objet <code>Date</code> standard (soit un intervalle de ±8 640 000 000 000 000 millisecondes).</p> - -<h3 id="Les_formats_de_date_et_les_conversions_entre_les_fuseaux_horaires">Les formats de date et les conversions entre les fuseaux horaires</h3> - -<p>Il existe différentes méthodes pour obtenir une date sous différents formats ou effectuer une conversion entre différents fuseaux. On distingue notamment les fonctions qui manipulent les dates relativement au temps universal coordonné (UTC). Le temps local est celui utilisé par l'appareil de l'utilisateur.</p> - -<p>Ainsi, on dispose de méthodes permettant d'obtenir ou de définir les différentes composantes d'une date selon le temps local (ex. {{jsxref("Date.getDay", "getDay()")}}, {{jsxref("Date.setHours", "setHours()")}}) et de méthodes équivalentes pour la manipulation en UTC (ex. {{jsxref("Date.getUTCDay()", "getUTCDay()")}} et {{jsxref("Date.setUTCHours", "setUTCHours()")}} respectivement).</p> - -<h2 id="Constructeur">Constructeur</h2> - -<dl> - <dt>{{jsxref("Date/Date", "Date()")}}</dt> - <dd>Cette fonction permet de créer un nouvel objet <code>Date</code>.</dd> -</dl> - -<h2 id="Méthodes_statiques">Méthodes statiques</h2> - -<dl> - <dt>{{jsxref("Date.now()")}}</dt> - <dd>Renvoie la valeur numérique correspondant au moment présent sous la forme du nombre de millisecondes écoulées depuis le premier janvier 1970 00:00:00 UTC (les secondes intercalaires (<em>leap seconds</em>) sont ignorées).</dd> - <dt>{{jsxref("Date.parse()")}}</dt> - <dd>Analyse la représentation textuelle d'une date et renvoie le nombre de millisecondes écoulées entre cette date et le premier janvier 1970, 00:00:00 UTC (les secondes intercalaires (<em>leap seconds</em>) sont ignorées). - <div class="note"> - <p><strong>Note :</strong> L'analyse de chaînes de caractères à l'aide de <code>Date.parse</code> est fortement déconseillée en raison des incohérences qui existent entre les navigateurs.</p> - </div> - </dd> - <dt>{{jsxref("Date.UTC()")}}</dt> - <dd>Accepte les mêmes paramètres que la forme longue du constructeur (c'est-à-dire entre 2 et 7) et renvoie le nombre de millisecondes entre cette date et le premier janvier 1970, 00:00:00 UTC (les secondes intercalaires (<em>leap seconds</em>) sont ignorées).</dd> -</dl> - -<h2 id="Méthodes_des_instances">Méthodes des instances</h2> - -<dl> - <dt>{{jsxref("Date.prototype.getDate()")}}</dt> - <dd>Renvoie le jour du mois (entre <code>1</code> et <code>31</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getDay()")}}</dt> - <dd>Renvoie le jour de la semaine (entre <code>0</code> et <code>6</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getFullYear()")}}</dt> - <dd>Renvoie l'année (sans chiffre implicite, <code>1999</code> sera renvoyé et pas <code>99</code> par exemple) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getHours()")}}</dt> - <dd>Renvoie l'heure (entre <code>0</code> et <code>23</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getMilliseconds()")}}</dt> - <dd>Renvoie les millisecondes (entre <code>0</code> et <code>999</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getMinutes()")}}</dt> - <dd>Renvoie les minutes (entre <code>0</code> et <code>59</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getMonth()")}}</dt> - <dd>Renvoie le mois (entre <code>0</code> et <code>11</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getSeconds()")}}</dt> - <dd>Renvoie les secondes (entre <code>0</code> et <code>59</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.getTime()")}}</dt> - <dd>Renvoie la valeur numérique de la date donnée, exprimée en nombre de millisecondes écoulées depuis le premier janvier 1970, 00:00:00 UTC (pour les temps antérieurs, ce sont des valeurs négatives qui seront renvoyées).</dd> - <dt>{{jsxref("Date.prototype.getTimezoneOffset()")}}</dt> - <dd>Renvoie le décalage horaire, exprimé en minutes, pour la locale courante.</dd> - <dt>{{jsxref("Date.prototype.getUTCDate()")}}</dt> - <dd>Renvoie le jour du mois (entre <code>1</code> et <code>31</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCDay()")}}</dt> - <dd>Renvoie le jour de la semaine (entre <code>0</code> et <code>6</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCFullYear()")}}</dt> - <dd>Renvoie l'année (sans chiffre implicite, <code>1999</code> sera renvoyé plutôt que <code>99</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCHours()")}}</dt> - <dd>Renvoie l'heure (entre <code>0</code> et <code>23</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</dt> - <dd>Renvoie les millisecondes (entre <code>0</code> et <code>999</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCMinutes()")}}</dt> - <dd>Renvoie les minutes (entre <code>0</code> et <code>59</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCMonth()")}}</dt> - <dd>Renvoie le mois (entre <code>0</code> et <code>11</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getUTCSeconds()")}}</dt> - <dd>Renvoie les secondes (entre <code>0</code> et <code>59</code>) pour la date donnée, selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.getYear()")}}</dt> - <dd>Renvoie l'année (généralement exprimée sur 2 ou 3 chiffres) pour la date donnée selon le temps local. <strong>On utilisera plutôt {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}}</strong>.</dd> - <dt>{{jsxref("Date.prototype.setDate()")}}</dt> - <dd>Définit le jour du mois pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setFullYear()")}}</dt> - <dd>Définit l'année (sans chiffre implicite, on utilisera <code>1999</code> et pas <code>99</code>) pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setHours()")}}</dt> - <dd>Définit les heures pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setMilliseconds()")}}</dt> - <dd>Définit les millisecondes pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setMinutes()")}}</dt> - <dd>Définit les minutes pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setMonth()")}}</dt> - <dd>Définit le mois pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setSeconds()")}}</dt> - <dd>Définit les secondes pour la date donnée, selon le temps local.</dd> - <dt>{{jsxref("Date.prototype.setTime()")}}</dt> - <dd>Définit le nombre de millisecondes écoulées depuis le premier janvier 1970, 00:00:00 UTC et la date donnée. On utilisera des nombres négatifs pour les moments antérieurs à cette date.</dd> - <dt>{{jsxref("Date.prototype.setUTCDate()")}}</dt> - <dd>Définit le jour du mois pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setUTCFullYear()")}}</dt> - <dd>Définit l'année (exprimée sans chiffres implicites, ex. <code>1999</code> et pas <code>99</code>) pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setUTCHours()")}}</dt> - <dd>Définit l'heure pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</dt> - <dd>Définit les millisecondes pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setUTCMinutes()")}}</dt> - <dd>Définit les minutes pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setUTCMonth()")}}</dt> - <dd>Définit le mois pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setUTCSeconds()")}}</dt> - <dd>Définit les secondes pour la date donnée selon le temps universel.</dd> - <dt>{{jsxref("Date.prototype.setYear()")}}</dt> - <dd>Définit l'année (avec 2 à 3 chiffres) pour la date courante selon le temps local. <strong>On privilégiera la méthode {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}} à la place.</strong></dd> - <dt>{{jsxref("Date.prototype.toDateString()")}}</dt> - <dd>Renvoie la partie "date" (jour, mois, année) de l'objet {{jsxref("Date")}} en une chaîne de caractères compréhensible par un humain (anglophone) (ex. <code>'Thu Apr 12 2018'</code>).</dd> - <dt>{{jsxref("Date.prototype.toISOString()")}}</dt> - <dd>Convertit une date en une chaîne de caractères selon le format ISO 8601 Étendu.</dd> - <dt>{{jsxref("Date.prototype.toJSON()")}}</dt> - <dd>Renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}} avec {{jsxref("Date.prototype.toISOString()", "toISOString()")}}. Cette méthode est utilisée par {{jsxref("JSON.stringify()")}}.</dd> - <dt>{{jsxref("Date.prototype.toGMTString()")}}</dt> - <dd>Renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}} d'après le fuseau GMT (UTC). <strong>On utilisera plutôt {{jsxref("Date.prototype.toUTCString()", "toUTCString()")}}</strong>.</dd> - <dt>{{jsxref("Date.prototype.toLocaleDateString()")}}</dt> - <dd>Renvoie une chaîne de caractères représentant les jours / mois / années de la date courante avec une représentation propre à la locale courante (déduite des paramètres systèmes utilisés).</dd> - <dt>{{jsxref("Date.prototype.toLocaleFormat()")}}</dt> - <dd>Convertit la date courante en une chaîne de caractères avec un format décrit en paramètre via une chaîne de caractères.</dd> - <dt>{{jsxref("Date.prototype.toLocaleString()")}}</dt> - <dd>Renvoie une chaîne de caractères représentant la date sous le forme de la locale courante. Cette méthode surcharge la méthode {{jsxref("Object.prototype.toLocaleString()")}}.</dd> - <dt>{{jsxref("Date.prototype.toLocaleTimeString()")}}</dt> - <dd>Renvoie une chaîne de caractères représentant les heures / minutes / secondes de la date courante avec une représentation propre à la locale courante (déduite des paramètres systèmes utilisés).</dd> - <dt>{{jsxref("Date.prototype.toString()")}}</dt> - <dd>Renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}} courant. Cette méthode surcharge la méthode {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Date.prototype.toTimeString()")}}</dt> - <dd>Renvoie l'heure (avec les minutes et les secondes) d'une date sous la forme d'une chaîne de caractères compréhensible par un humain.</dd> - <dt>{{jsxref("Date.prototype.toUTCString()")}}</dt> - <dd>Convertit une date en chaîne de caractère en utilisant le temps universel comme référentiel.</dd> - <dt>{{jsxref("Date.prototype.valueOf()")}}</dt> - <dd>Renvoie la valeur primitive d'un objet {{jsxref("Date")}}. Cette méthode surcharge la méthode {{jsxref("Object.prototype.valueOf()")}}.</dd> -</dl> - -<h2 id="Exemples">Exemples</h2> - -<h3 id="Différentes_façons_de_créer_un_objet_Date">Différentes façons de créer un objet <code>Date</code></h3> - -<p>Les exemples qui suivent illustrent différentes méthodes permettant de créer des dates JavaScript :</p> - -<div class="note"> -<p><strong>Note :</strong> L'analyse de chaîne de caractères représentant des dates avec le constructeur <code>Date</code> (ou <code>Date.parse</code> qui est équivalent) est fortement déconseillée en raison des différences de comportement existant entre les navigateurs.</p> -</div> - -<pre class="brush: js notranslate">let aujourdhui = new Date() +{{JSRef}} + +Les objets JavaScript **`Date`** représentent un instant donné sur l'axe du temps dans un format indépendant de la plateforme utilisée. Les objets `Date` contiennent un nombre (`Number`) qui représente le nombre de millisecondes écoulées depuis le premier janvier 1970 sur l'échelle [UTC](https://fr.wikipedia.org/wiki/Temps_universel_coordonn%C3%A9). + +> **Note :** TC39 travaille actuellement sur [Temporal](https://tc39.es/proposal-temporal/docs/index.html), une nouvelle API pour la gestion des dates, heures et données temporelles. +> Pour en savoir plus, consultez le [blog d'Igalia](https://blogs.igalia.com/compilers/2020/06/23/dates-and-times-in-javascript/) et n'hésitez pas à répondre [au sondage](https://forms.gle/iL9iZg7Y9LvH41Nv8). Les retours concrets de développeurs web sont importants pour affiner cette API. Attention, elle n'est pas encore prête à être utilisée en production ! + +## Description + +### L'epoch ECMAScript + +D'un point de vue technique, une date JavaScript correspond au nombre de millisecondes écoulées depuis le premier janvier 1970, minuit UTC. Cette date et cette heure sont les mêmes que **l'[epoch](https://fr.wikipedia.org/wiki/Epoch) UNIX**, qui est l'instant de référence principalement utilisé pour manipuler les dates/heures dans les systèmes informatiques. + +> **Note :** Bien que les valeurs temporelles des objets dates soient relatives à UTC, certaines des méthodes simples pour obtenir les composantes d'une date/heure fonctionnent relativement au fuseau horaire du système. + +On notera également que la représentation maximale d'un objet `Date` n'est pas la même que le plus grand entier représentable en JavaScript (`Number.MAX_SAFE_INTEGER` vaut 9,007,199,254,740,991). En effet, ECMA-262 définit un maximum de ±100 000 000 (cent millions) jours relatifs au premier janvier 1970 UTC (ce qui correspond au 20 avril 271 821 avant notre ètre d'une part et au 13 septembre 275 760 de notre ère) pouvant être représentés par un objet `Date` standard (soit un intervalle de ±8 640 000 000 000 000 millisecondes). + +### Les formats de date et les conversions entre les fuseaux horaires + +Il existe différentes méthodes pour obtenir une date sous différents formats ou effectuer une conversion entre différents fuseaux. On distingue notamment les fonctions qui manipulent les dates relativement au temps universal coordonné (UTC). Le temps local est celui utilisé par l'appareil de l'utilisateur. + +Ainsi, on dispose de méthodes permettant d'obtenir ou de définir les différentes composantes d'une date selon le temps local (ex. {{jsxref("Date.getDay", "getDay()")}}, {{jsxref("Date.setHours", "setHours()")}}) et de méthodes équivalentes pour la manipulation en UTC (ex. {{jsxref("Date.getUTCDay()", "getUTCDay()")}} et {{jsxref("Date.setUTCHours", "setUTCHours()")}} respectivement). + +## Constructeur + +- {{jsxref("Date/Date", "Date()")}} + - : Cette fonction permet de créer un nouvel objet `Date`. + +## Méthodes statiques + +- {{jsxref("Date.now()")}} + - : Renvoie la valeur numérique correspondant au moment présent sous la forme du nombre de millisecondes écoulées depuis le premier janvier 1970 00:00:00 UTC (les secondes intercalaires (_leap seconds_) sont ignorées). +- {{jsxref("Date.parse()")}} + + - : Analyse la représentation textuelle d'une date et renvoie le nombre de millisecondes écoulées entre cette date et le premier janvier 1970, 00:00:00 UTC (les secondes intercalaires (_leap seconds_) sont ignorées). + + > **Note :** L'analyse de chaînes de caractères à l'aide de `Date.parse` est fortement déconseillée en raison des incohérences qui existent entre les navigateurs. + +- {{jsxref("Date.UTC()")}} + - : Accepte les mêmes paramètres que la forme longue du constructeur (c'est-à-dire entre 2 et 7) et renvoie le nombre de millisecondes entre cette date et le premier janvier 1970, 00:00:00 UTC (les secondes intercalaires (_leap seconds_) sont ignorées). + +## Méthodes des instances + +- {{jsxref("Date.prototype.getDate()")}} + - : Renvoie le jour du mois (entre `1` et `31`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getDay()")}} + - : Renvoie le jour de la semaine (entre `0` et `6`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getFullYear()")}} + - : Renvoie l'année (sans chiffre implicite, `1999` sera renvoyé et pas `99` par exemple) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getHours()")}} + - : Renvoie l'heure (entre `0` et `23`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getMilliseconds()")}} + - : Renvoie les millisecondes (entre `0` et `999`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getMinutes()")}} + - : Renvoie les minutes (entre `0` et `59`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getMonth()")}} + - : Renvoie le mois (entre `0` et `11`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getSeconds()")}} + - : Renvoie les secondes (entre `0` et `59`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.getTime()")}} + - : Renvoie la valeur numérique de la date donnée, exprimée en nombre de millisecondes écoulées depuis le premier janvier 1970, 00:00:00 UTC (pour les temps antérieurs, ce sont des valeurs négatives qui seront renvoyées). +- {{jsxref("Date.prototype.getTimezoneOffset()")}} + - : Renvoie le décalage horaire, exprimé en minutes, pour la locale courante. +- {{jsxref("Date.prototype.getUTCDate()")}} + - : Renvoie le jour du mois (entre `1` et `31`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCDay()")}} + - : Renvoie le jour de la semaine (entre `0` et `6`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCFullYear()")}} + - : Renvoie l'année (sans chiffre implicite, `1999` sera renvoyé plutôt que `99`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCHours()")}} + - : Renvoie l'heure (entre `0` et `23`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCMilliseconds()")}} + - : Renvoie les millisecondes (entre `0` et `999`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCMinutes()")}} + - : Renvoie les minutes (entre `0` et `59`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCMonth()")}} + - : Renvoie le mois (entre `0` et `11`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getUTCSeconds()")}} + - : Renvoie les secondes (entre `0` et `59`) pour la date donnée, selon le temps universel. +- {{jsxref("Date.prototype.getYear()")}} + - : Renvoie l'année (généralement exprimée sur 2 ou 3 chiffres) pour la date donnée selon le temps local. **On utilisera plutôt {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}}**. +- {{jsxref("Date.prototype.setDate()")}} + - : Définit le jour du mois pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setFullYear()")}} + - : Définit l'année (sans chiffre implicite, on utilisera `1999` et pas `99`) pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setHours()")}} + - : Définit les heures pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setMilliseconds()")}} + - : Définit les millisecondes pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setMinutes()")}} + - : Définit les minutes pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setMonth()")}} + - : Définit le mois pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setSeconds()")}} + - : Définit les secondes pour la date donnée, selon le temps local. +- {{jsxref("Date.prototype.setTime()")}} + - : Définit le nombre de millisecondes écoulées depuis le premier janvier 1970, 00:00:00 UTC et la date donnée. On utilisera des nombres négatifs pour les moments antérieurs à cette date. +- {{jsxref("Date.prototype.setUTCDate()")}} + - : Définit le jour du mois pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setUTCFullYear()")}} + - : Définit l'année (exprimée sans chiffres implicites, ex. `1999` et pas `99`) pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setUTCHours()")}} + - : Définit l'heure pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setUTCMilliseconds()")}} + - : Définit les millisecondes pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setUTCMinutes()")}} + - : Définit les minutes pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setUTCMonth()")}} + - : Définit le mois pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setUTCSeconds()")}} + - : Définit les secondes pour la date donnée selon le temps universel. +- {{jsxref("Date.prototype.setYear()")}} + - : Définit l'année (avec 2 à 3 chiffres) pour la date courante selon le temps local. **On privilégiera la méthode {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}} à la place.** +- {{jsxref("Date.prototype.toDateString()")}} + - : Renvoie la partie "date" (jour, mois, année) de l'objet {{jsxref("Date")}} en une chaîne de caractères compréhensible par un humain (anglophone) (ex. `'Thu Apr 12 2018'`). +- {{jsxref("Date.prototype.toISOString()")}} + - : Convertit une date en une chaîne de caractères selon le format ISO 8601 Étendu. +- {{jsxref("Date.prototype.toJSON()")}} + - : Renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}} avec {{jsxref("Date.prototype.toISOString()", "toISOString()")}}. Cette méthode est utilisée par {{jsxref("JSON.stringify()")}}. +- {{jsxref("Date.prototype.toGMTString()")}} + - : Renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}} d'après le fuseau GMT (UTC). **On utilisera plutôt {{jsxref("Date.prototype.toUTCString()", "toUTCString()")}}**. +- {{jsxref("Date.prototype.toLocaleDateString()")}} + - : Renvoie une chaîne de caractères représentant les jours / mois / années de la date courante avec une représentation propre à la locale courante (déduite des paramètres systèmes utilisés). +- {{jsxref("Date.prototype.toLocaleFormat()")}} + - : Convertit la date courante en une chaîne de caractères avec un format décrit en paramètre via une chaîne de caractères. +- {{jsxref("Date.prototype.toLocaleString()")}} + - : Renvoie une chaîne de caractères représentant la date sous le forme de la locale courante. Cette méthode surcharge la méthode {{jsxref("Object.prototype.toLocaleString()")}}. +- {{jsxref("Date.prototype.toLocaleTimeString()")}} + - : Renvoie une chaîne de caractères représentant les heures / minutes / secondes de la date courante avec une représentation propre à la locale courante (déduite des paramètres systèmes utilisés). +- {{jsxref("Date.prototype.toString()")}} + - : Renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}} courant. Cette méthode surcharge la méthode {{jsxref("Object.prototype.toString()")}}. +- {{jsxref("Date.prototype.toTimeString()")}} + - : Renvoie l'heure (avec les minutes et les secondes) d'une date sous la forme d'une chaîne de caractères compréhensible par un humain. +- {{jsxref("Date.prototype.toUTCString()")}} + - : Convertit une date en chaîne de caractère en utilisant le temps universel comme référentiel. +- {{jsxref("Date.prototype.valueOf()")}} + - : Renvoie la valeur primitive d'un objet {{jsxref("Date")}}. Cette méthode surcharge la méthode {{jsxref("Object.prototype.valueOf()")}}. + +## Exemples + +### Différentes façons de créer un objet `Date` + +Les exemples qui suivent illustrent différentes méthodes permettant de créer des dates JavaScript : + +> **Note :** L'analyse de chaîne de caractères représentant des dates avec le constructeur `Date` (ou `Date.parse` qui est équivalent) est fortement déconseillée en raison des différences de comportement existant entre les navigateurs. + +```js +let aujourdhui = new Date() let anniversaire = new Date('September 22, 2018 15:00:00') let anniversaire = new Date('2018-09-22T15:00:00') let anniversaire = new Date(2018, 8, 22) // the month is 0-indexed let anniversaire = new Date(2018, 8, 22, 15, 0, 0) -</pre> +``` -<h3 id="Les_années_sur_deux_chiffres_correspondent_à_la_période_1900_–_1999">Les années sur deux chiffres correspondent à la période 1900 – 1999</h3> +### Les années sur deux chiffres correspondent à la période 1900 – 1999 -<p>Afin de créer et de manipuler des dates sur les années <code>0</code> à <code>99</code> de notre ère, on doit utiliser les méthodes {{jsxref("Date.prototype.setFullYear()")}} and {{jsxref("Date.prototype.getFullYear()")}}.</p> +Afin de créer et de manipuler des dates sur les années `0` à `99` de notre ère, on doit utiliser les méthodes {{jsxref("Date.prototype.setFullYear()")}} and {{jsxref("Date.prototype.getFullYear()")}}. -<pre class="brush: js notranslate">let date = new Date(98, 1) // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT) +```js +let date = new Date(98, 1) // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT) // Méthode dépréciée, 98 correspond également ici à 1998 date.setYear(98) // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT) date.setFullYear(98) // Sat Feb 01 0098 00:00:00 GMT+0000 (BST) -</pre> +``` -<h3 id="Calculer_le_temps_écoulé">Calculer le temps écoulé</h3> +### Calculer le temps écoulé -<p>Dans les exemples suivants, on illustre comment calculer le temps écoulé entre deux dates JavaScript en millisecondes.</p> +Dans les exemples suivants, on illustre comment calculer le temps écoulé entre deux dates JavaScript en millisecondes. -<p>En raison de durées différentes pour les jours (heure d'été / heure d'hiver), les mois et les années, il faudra faire attention et étudier le sujet avant d'exprimer des durées en unités supérieures à des heures / minutes / secondes.</p> +En raison de durées différentes pour les jours (heure d'été / heure d'hiver), les mois et les années, il faudra faire attention et étudier le sujet avant d'exprimer des durées en unités supérieures à des heures / minutes / secondes. -<pre class="brush: js notranslate">// Utiliser des objets Date +```js +// Utiliser des objets Date let debut = Date.now() // Ici, l'évènement dont on veut mesurer la durée : faireQuelqueChosePendantLongtemps() let fin = Date.now() let duree = fin - debut // La durée écoulée, en millisecondes -</pre> +``` -<pre class="brush: js notranslate">// En utilisant les méthodes natives +```js +// En utilisant les méthodes natives let debut = new Date() // Ici, l'évènement dont on veut mesurer la durée : faireQuelqueChosePendantLongtemps() let fin = new Date() let duree = fin.getTime() - debut.getTime() // La durée écoulée, en millisecondes -</pre> +``` -<pre class="brush: js notranslate">// Pour tester le temps d'exécution d'une fonction +```js +// Pour tester le temps d'exécution d'une fonction function afficheDureeEcoulee(fTest) { let debut = Date.now(), valRetour = fTest(), @@ -217,40 +213,28 @@ function afficheDureeEcoulee(fTest) { } let valeurDeRetour = afficheDureeEcoulee(maFonctionATester) -</pre> +``` -<div class="note"> -<p><strong>Note :</strong> Pour les navigateurs qui prennent en charge l'{{domxref("Window.performance", "API Web Performance", "", 1)}}, la méthode {{domxref("Performance.now()")}} peut fournir un outil de mesure des durées écoulées plus fiable et précis que {{jsxref("Date.now()")}}.</p> -</div> +> **Note :** Pour les navigateurs qui prennent en charge l'{{domxref("Window.performance", "API Web Performance", "", 1)}}, la méthode {{domxref("Performance.now()")}} peut fournir un outil de mesure des durées écoulées plus fiable et précis que {{jsxref("Date.now()")}}. -<h3 id="Obtenir_le_nombre_de_secondes_écoulées_depuis_lepoch_ECMAScript">Obtenir le nombre de secondes écoulées depuis l'epoch ECMAScript</h3> +### Obtenir le nombre de secondes écoulées depuis l'epoch ECMAScript -<pre class="brush: js notranslate">let secondes = Math.floor(Date.now() / 1000) -</pre> +```js +let secondes = Math.floor(Date.now() / 1000) +``` -<p>Dans ce cas, on renvoie un entier et c'est pour ça qu'on utilise {{jsxref("Math.floor()")}}. Par ailleurs, on n'utilise pas {{jsxref("Math.round()")}} afin d'avoir le nombre de secondes effectivement écoulées.</p> +Dans ce cas, on renvoie un entier et c'est pour ça qu'on utilise {{jsxref("Math.floor()")}}. Par ailleurs, on n'utilise pas {{jsxref("Math.round()")}} afin d'avoir le nombre de secondes effectivement écoulées. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ESDraft', '#sec-date-objects', 'Date')}}</td> - </tr> - </tbody> -</table> +| Spécification | +| -------------------------------------------------------------------- | +| {{SpecName('ESDraft', '#sec-date-objects', 'Date')}} | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.Date", 3)}}</p> +{{Compat("javascript.builtins.Date", 3)}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>Le constructeur {{jsxref("Date/Date", "Date()")}}</li> -</ul> +- Le constructeur {{jsxref("Date/Date", "Date()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/now/index.md b/files/fr/web/javascript/reference/global_objects/date/now/index.md index 271fbf39bb..27cfc90da5 100644 --- a/files/fr/web/javascript/reference/global_objects/date/now/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/now/index.md @@ -10,43 +10,44 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/now original_slug: Web/JavaScript/Reference/Objets_globaux/Date/now --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>Date.now()</code></strong> renvoie le nombre de millisecondes écoulées depuis le 1er Janvier 1970 00:00:00 UTC.</p> +La méthode **`Date.now()`** renvoie le nombre de millisecondes écoulées depuis le 1er Janvier 1970 00:00:00 UTC. -<div>{{EmbedInteractiveExample("pages/js/date-now.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-now.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var tempsEnMs = Date.now(); -</pre> + var tempsEnMs = Date.now(); -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC.</p> +Le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>now()</code> renvoie le nombre de millisecondes écoulées depuis le 1er janvier 1970 00:00:00 UTC sous forme d'un {{jsxref("Number")}} (nombre).</p> +La méthode `now()` renvoie le nombre de millisecondes écoulées depuis le 1er janvier 1970 00:00:00 UTC sous forme d'un {{jsxref("Number")}} (nombre). -<p><code>now()</code> étant une méthode statique de {{jsxref("Date")}}, on utilisera toujours la forme <code>Date.now()</code>.</p> +`now()` étant une méthode statique de {{jsxref("Date")}}, on utilisera toujours la forme `Date.now()`. -<h2 id="Prothèse_d'émulation_(polyfill)">Prothèse d'émulation (<em>polyfill</em>)</h2> +## Prothèse d'émulation (_polyfill_) -<p>Cette méthode a été standardisée dans la 5e édition d'ECMA-262. Les moteurs JavaScript ne la supportant pas peuvent l'émuler de la façon suivante :</p> +Cette méthode a été standardisée dans la 5e édition d'ECMA-262. Les moteurs JavaScript ne la supportant pas peuvent l'émuler de la façon suivante : -<pre class="brush: js">if (!Date.now) { +```js +if (!Date.now) { Date.now = function now() { return new Date().getTime(); }; } -</pre> +``` -<h2 id="Précision_temporelle_réduite">Précision temporelle réduite</h2> +## Précision temporelle réduite -<p>Afin de protéger contre les attaques de minutage et d'identification, la précision de <code>new Date.now()</code> peut être arrondie en fonction des paramètres du navigateur. Pour Firefox, la préférence <code>privacy.reduceTimerPrecision</code> est activée par défaut et vaut, par défaut 20ms pour Firefox 59 et 2ms pour Firefox 60.</p> +Afin de protéger contre les attaques de minutage et d'identification, la précision de `new Date.now()` peut être arrondie en fonction des paramètres du navigateur. Pour Firefox, la préférence `privacy.reduceTimerPrecision` est activée par défaut et vaut, par défaut 20ms pour Firefox 59 et 2ms pour Firefox 60. -<pre class="brush: js">// Précision temporelle réduite (2ms) pour Firefox 60 +```js +// Précision temporelle réduite (2ms) pour Firefox 60 new Date().getTime(); // 1519211809934 // 1519211810362 @@ -60,44 +61,23 @@ new Date().getTime(); // 1519129858900 // 1519129864400 // ... -</pre> - -<p>Pour Firefox, il est également possible d'activer <code>privacy.resistFingerprinting</code> auquel cas la précision sera 100ms ou la valeur de <code>privacy.resistFingerprinting.reduceTimerPrecision.microseconds</code> selon laquelle est plus grande.</p> - -<h2 id="Spécifications">Spécifications</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('ES5.1', '#sec-15.9.4.4', 'Date.now')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.5.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.now', 'Date.now')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.now', 'Date.now')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.now")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("window.performance.now")}} - renvoie des timestamps (horodatages) avec une précision supérieure à la milliseconde pour mesurer la performance des pages web.</li> - <li>{{domxref("console.time")}} / {{domxref("console.timeEnd")}}</li> -</ul> +``` + +Pour Firefox, il est également possible d'activer `privacy.resistFingerprinting` auquel cas la précision sera 100ms ou la valeur de `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` selon laquelle est plus grande. + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES5.1', '#sec-15.9.4.4', 'Date.now')}} | {{Spec2('ES5.1')}} | Définition initiale. Implémentée avec JavaScript 1.5. | +| {{SpecName('ES6', '#sec-date.now', 'Date.now')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.now', 'Date.now')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.now")}} + +## Voir aussi + +- {{domxref("window.performance.now")}} - renvoie des timestamps (horodatages) avec une précision supérieure à la milliseconde pour mesurer la performance des pages web. +- {{domxref("console.time")}} / {{domxref("console.timeEnd")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/parse/index.md b/files/fr/web/javascript/reference/global_objects/date/parse/index.md index 86226b698a..5aebdfbe75 100644 --- a/files/fr/web/javascript/reference/global_objects/date/parse/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/parse/index.md @@ -9,187 +9,169 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/parse original_slug: Web/JavaScript/Reference/Objets_globaux/Date/parse --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>Date.parse()</code></strong><strong> </strong>analyse la représentation textuelle d'une date, et renvoie le nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 UTC jusqu'à cette date ou <code>NaN</code> si la chaîne n'est pas reconnue ou décrit une date invalide (par exemple 2015-02-31).</p> +La méthode **`Date.parse()`\*\*** \*\*analyse la représentation textuelle d'une date, et renvoie le nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 UTC jusqu'à cette date ou `NaN` si la chaîne n'est pas reconnue ou décrit une date invalide (par exemple 2015-02-31). -<div class="note"> -<p><strong>Note :</strong> Pour les anciennes implémentations (avant ES5), le résultat de <code>Date.</code><code>parse</code> variait d'une implémentation à l'autre. Attention donc à la compatibilité avec ces anciennes versions.</p> -</div> +> **Note :** Pour les anciennes implémentations (avant ES5), le résultat de ` Date.``parse ` variait d'une implémentation à l'autre. Attention donc à la compatibilité avec ces anciennes versions. -<div>{{EmbedInteractiveExample("pages/js/date-parse.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-parse.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<p>Appel direct :</p> +Appel direct : -<pre class="syntaxbox notranslate">Date.parse(dateString)</pre> + Date.parse(dateString) -<p>Appel implicite :</p> +Appel implicite : -<pre class="syntaxbox notranslate">new Date(<var>dateString</var>)</pre> + new Date(dateString) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>dateString</code></dt> - <dd>Une chaine de caractères représentant une date dans une version simplifiéee d'ISO 8601 (d'autres formats peuvent être utilisés mais les résultats ne sont pas garantis).</dd> -</dl> +- `dateString` + - : Une chaine de caractères représentant une date dans une version simplifiéee d'ISO 8601 (d'autres formats peuvent être utilisés mais les résultats ne sont pas garantis). -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un nombre correspondant au nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date indiquée en argument sous la forme d'une chaîne de caractères. Si l'argument ne permet pas de décrire une date valide, c'est {{jsxref("NaN")}} qui sera renvoyé.</p> +Un nombre correspondant au nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date indiquée en argument sous la forme d'une chaîne de caractères. Si l'argument ne permet pas de décrire une date valide, c'est {{jsxref("NaN")}} qui sera renvoyé. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>parse</code> prend en argument une chaine de caractères contenant une date en paramètre (comme "<code>Dec 25, 1995</code>") et renvoie le nombre de millièmes de secondes depuis le 1er janvier 1970, 00:00:00 UTC. Cette fonction est utile pour définir des valeurs de dates à partir de représentations textuelles, par exemple en conjonction avec la méthode {{jsxref("Objets_globaux/Date/setTime", "setTime()")}} et l'objet {{jsxref("Objets_globaux/Date", "Date")}}.</p> +La méthode `parse` prend en argument une chaine de caractères contenant une date en paramètre (comme "`Dec 25, 1995`") et renvoie le nombre de millièmes de secondes depuis le 1er janvier 1970, 00:00:00 UTC. Cette fonction est utile pour définir des valeurs de dates à partir de représentations textuelles, par exemple en conjonction avec la méthode {{jsxref("Objets_globaux/Date/setTime", "setTime()")}} et l'objet {{jsxref("Objets_globaux/Date", "Date")}}. -<h3 id="Format_de_la_chaîne_de_caractères">Format de la chaîne de caractères</h3> +### Format de la chaîne de caractères -<p>À partir d'une chaine de caractères représentant une date, <code>parse</code> renvoie une valeur de temps. La syntaxe acceptée est un format simplifié de la norme ISO 8601. On pourra par exemple utiliser <code>"2011-10-10"</code> (date uniquement), <code>"2011-10-10T14:48:00"</code> (date et heure) ou <code>"2011-10-10T14:48:00.000+09:00"</code> (date, heure, millisecondes et fuseau horaire).</p> +À partir d'une chaine de caractères représentant une date, `parse` renvoie une valeur de temps. La syntaxe acceptée est un format simplifié de la norme ISO 8601. On pourra par exemple utiliser `"2011-10-10"` (date uniquement), `"2011-10-10T14:48:00"` (date et heure) ou `"2011-10-10T14:48:00.000+09:00"` (date, heure, millisecondes et fuseau horaire). -<p>Si aucun fuseau horaire n'est spécifié, les chaînes représentant uniquement des dates seront considérées comme UTC et les dates / heures seront considérées comme locales.</p> +Si aucun fuseau horaire n'est spécifié, les chaînes représentant uniquement des dates seront considérées comme UTC et les dates / heures seront considérées comme locales. -<p>Lorsque des indicateurs de fuseau horaire sont utilisés, la valeur renvoyée correspondra toujours au nombre de millisecondes écoulées entre l'argument et le premier janvier 1970 à minuit UTC.</p> +Lorsque des indicateurs de fuseau horaire sont utilisés, la valeur renvoyée correspondra toujours au nombre de millisecondes écoulées entre l'argument et le premier janvier 1970 à minuit UTC. -<p><code>parse()</code> est une méthode statique de {{jsxref("Date")}} et on invoquera ainsi <code>Date.parse()</code> plutôt que <code>parse()</code> sur une instance d'un objet <code>Date</code>.</p> +`parse()` est une méthode statique de {{jsxref("Date")}} et on invoquera ainsi `Date.parse()` plutôt que `parse()` sur une instance d'un objet `Date`. -<h3 id="Différences_entre_les_fuseaux_horaires_supposés">Différences entre les fuseaux horaires supposés</h3> +### Différences entre les fuseaux horaires supposés -<p>Avec une chaîne comme <code>"March 7, 2014"</code>, <code>parse()</code> supposera un fuseau horaire local, avec une chaîne au format ISO comme <code>"2014-03-07"</code>, la méthode supposera un fuseau horaire UTC en ES5 et un fuseau horaire local pour ECMAScript 2015. Ainsi les objets {{jsxref("Date")}} construits avec ces chaînes représenteront des instants différents, sauf si le fuseau horaire local du système utilisé correspond à UTC. Cela signifie que deux dates représentées de façon textuelles semblables peuvent donner des dates différentes (ce comportement doit être corrigé avec ECMAScript 6 afin que les deux dates soient traitées de façon locale).</p> +Avec une chaîne comme `"March 7, 2014"`, `parse()` supposera un fuseau horaire local, avec une chaîne au format ISO comme `"2014-03-07"`, la méthode supposera un fuseau horaire UTC en ES5 et un fuseau horaire local pour ECMAScript 2015. Ainsi les objets {{jsxref("Date")}} construits avec ces chaînes représenteront des instants différents, sauf si le fuseau horaire local du système utilisé correspond à UTC. Cela signifie que deux dates représentées de façon textuelles semblables peuvent donner des dates différentes (ce comportement doit être corrigé avec ECMAScript 6 afin que les deux dates soient traitées de façon locale). -<h3 id="Traitement_laissé_libre_à_limplémentation">Traitement laissé libre à l'implémentation</h3> +### Traitement laissé libre à l'implémentation -<p>Le standard ECMAScript dicte que si la chaîne utilisée n'est pas conforme au format standard, alors la fonction peut utiliser une heuristique et/ou un algorithme d'analyse de texte propre à l'implémentation. Les chaînes impossibles à décoder et/ou qui contiennent des éléments non-conformes aux formats ISO doivent renvoyer {{jsxref("NaN")}} lors de l'appel à <code>Date.parse()</code>.</p> +Le standard ECMAScript dicte que si la chaîne utilisée n'est pas conforme au format standard, alors la fonction peut utiliser une heuristique et/ou un algorithme d'analyse de texte propre à l'implémentation. Les chaînes impossibles à décoder et/ou qui contiennent des éléments non-conformes aux formats ISO doivent renvoyer {{jsxref("NaN")}} lors de l'appel à `Date.parse()`. -<p>Cependant, les valeurs invalides qui ne sont pas reconnues dans un format ISO pris en charge par ECMA-262 peuvent ou non engendrer la valeur {{jsxref("NaN")}} selon le navigateur et les valeurs utilisées. Par exemple :</p> +Cependant, les valeurs invalides qui ne sont pas reconnues dans un format ISO pris en charge par ECMA-262 peuvent ou non engendrer la valeur {{jsxref("NaN")}} selon le navigateur et les valeurs utilisées. Par exemple : -<pre class="brush: js notranslate">// Chaîne non ISO avec des valeurs invalides -new Date('23/25/2014');</pre> +```js +// Chaîne non ISO avec des valeurs invalides +new Date('23/25/2014'); +``` -<p>sera traitée comme la date locale du 25 novembre 2015 avec Firefox 30 et comme invalide avec Safari 7. Cependant, si la chaîne est reconnue dans un format ISO mais contient des valeurs invalides, la méthode renverra {{jsxref("NaN")}} pour tous les navigateurs conformes à ES5 (ou aux versions ultérieures) :</p> +sera traitée comme la date locale du 25 novembre 2015 avec Firefox 30 et comme invalide avec Safari 7. Cependant, si la chaîne est reconnue dans un format ISO mais contient des valeurs invalides, la méthode renverra {{jsxref("NaN")}} pour tous les navigateurs conformes à ES5 (ou aux versions ultérieures) : -<pre class="brush: js notranslate">// Chaîne ISO avec des valeurs invalides new +```js +// Chaîne ISO avec des valeurs invalides new Date('2014-25-23').toISOString(); -// renvoie "RangeError: invalid date" pour les navigateurs ES5</pre> +// renvoie "RangeError: invalid date" pour les navigateurs ES5 +``` -<p>L'implémentation spécifique de SpiderMonkey peut être trouvée dans le fichier <a href="https://dxr.mozilla.org/mozilla-central/source/js/src/jsdate.cpp?rev=64553c483cd1#889"><code>jsdate.cpp</code></a>. La chaîne <code>"10 06 2014"</code> est un exemple de chaîne non ISO, utiliser parse() sur cette chaîne entraînera le moteur JavaScript à utiliser son implémentation de recours. Voir ce <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1023155#c6">bug</a> pour une explication rapide de la façon dont est faite l'analyse de la chaîne.</p> +L'implémentation spécifique de SpiderMonkey peut être trouvée dans le fichier [`jsdate.cpp`](https://dxr.mozilla.org/mozilla-central/source/js/src/jsdate.cpp?rev=64553c483cd1#889). La chaîne `"10 06 2014"` est un exemple de chaîne non ISO, utiliser parse() sur cette chaîne entraînera le moteur JavaScript à utiliser son implémentation de recours. Voir ce [bug](https://bugzilla.mozilla.org/show_bug.cgi?id=1023155#c6) pour une explication rapide de la façon dont est faite l'analyse de la chaîne. -<pre class="brush: js notranslate">new Date('10 06 2014');</pre> +```js +new Date('10 06 2014'); +``` -<p>sera traitée comme la date locale du 6 octobre 2014 et non comme le 10 juin 2014. D'autres exemples :</p> +sera traitée comme la date locale du 6 octobre 2014 et non comme le 10 juin 2014. D'autres exemples : -<pre class="brush: js notranslate">new Date('toto-truc 2014').toString(); +```js +new Date('toto-truc 2014').toString(); // renvoie : "Invalid Date" Date.parse('toto-truc 2014'); -// renvoie : NaN</pre> +// renvoie : NaN +``` -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_Date.parse">Utiliser <code>Date.parse()</code></h3> +### Utiliser `Date.parse()` -<p>Les appels suivants renvoient tous <code>1546300800000</code>. Dans le premier appel, on indique uniquement la date (et donc le fuseau UTC implicite). Les chaînes qui suivent utilisent une indication de fuseau horaire selon la norme ISO (<code>Z</code> et <code>+00:00</code>)</p> +Les appels suivants renvoient tous `1546300800000`. Dans le premier appel, on indique uniquement la date (et donc le fuseau UTC implicite). Les chaînes qui suivent utilisent une indication de fuseau horaire selon la norme ISO (`Z` et `+00:00`) -<pre class="brush: js notranslate">Date.parse("2019-01-01") +```js +Date.parse("2019-01-01") Date.parse("2019-01-01T00:00:00.000Z") Date.parse("2019-01-01T00:00:00.000+00:00") -</pre> +``` -<p>L'appel suivant, qui ne précise pas le fuseau horaire, fournira le nombre de millisecondes écoulées entre le premier janvier 1970 minuit UTC et le premier janvier 2019 à minuit selon l'heure locale du système utilisé.</p> +L'appel suivant, qui ne précise pas le fuseau horaire, fournira le nombre de millisecondes écoulées entre le premier janvier 1970 minuit UTC et le premier janvier 2019 à minuit selon l'heure locale du système utilisé. -<pre class="brush: js notranslate">Date.parse("2019-01-01T00:00:00") -</pre> +```js +Date.parse("2019-01-01T00:00:00") +``` -<h3 id="Chaînes_de_caractères_non-standard">Chaînes de caractères non-standard</h3> +### Chaînes de caractères non-standard -<div class="blockIndicator note"> -<p><strong>Note :</strong> Cette section contient des exemples qui reposent sur des comportements spécifiques aux implémentations et on peut donc avoir des incohérences entre les moteurs utilisés.</p> -</div> +> **Note :** Cette section contient des exemples qui reposent sur des comportements spécifiques aux implémentations et on peut donc avoir des incohérences entre les moteurs utilisés. -<p>Si <code>IPOdate</code> est un objet {{jsxref("Date")}}, on peut définir sa valeur au 9 août 1995 (heure locale), de la façon suivante :</p> +Si `IPOdate` est un objet {{jsxref("Date")}}, on peut définir sa valeur au 9 août 1995 (heure locale), de la façon suivante : -<pre class="brush: js notranslate">IPOdate.setTime(Date.parse('Aug 9, 1995')); -</pre> +```js +IPOdate.setTime(Date.parse('Aug 9, 1995')); +``` -<p>Voici un autre exemple avec une chaîne qui ne suit pas le format standard.</p> +Voici un autre exemple avec une chaîne qui ne suit pas le format standard. -<pre class="brush: js notranslate">Date.parse('Aug 9, 1995'); -</pre> +```js +Date.parse('Aug 9, 1995'); +``` -<p>Cette méthode renverra <code>807937200000</code> pour le fuseau horaire GMT-0300 et d'autres valeurs pour d'autres fuseaux car la chaîne n'indique pas le fuseau horaire et ne respecte pas le format ISO (le fuseau considéré par défaut est donc le fuseau local).</p> +Cette méthode renverra `807937200000` pour le fuseau horaire GMT-0300 et d'autres valeurs pour d'autres fuseaux car la chaîne n'indique pas le fuseau horaire et ne respecte pas le format ISO (le fuseau considéré par défaut est donc le fuseau local). -<pre class="brush: js notranslate">Date.parse('Wed, 09 Aug 1995 00:00:00 GMT'); -</pre> +```js +Date.parse('Wed, 09 Aug 1995 00:00:00 GMT'); +``` -<p>Renvoie <code>807926400000</code> quel que soit le fuseau local car on indique GMT.</p> +Renvoie `807926400000` quel que soit le fuseau local car on indique GMT. -<pre class="brush: js notranslate">Date.parse('Wed, 09 Aug 1995 00:00:00'); -</pre> +```js +Date.parse('Wed, 09 Aug 1995 00:00:00'); +``` -<p>Renvoie <code>807937200000</code> dans le fuseau GMT-0300 et d'autres valeurs pour d'autres fuseaux car aucune indication de fuseau n'est fournie et que la chaîne n'est pas au format ISO, elle est donc traitée comme un temps local.</p> +Renvoie `807937200000` dans le fuseau GMT-0300 et d'autres valeurs pour d'autres fuseaux car aucune indication de fuseau n'est fournie et que la chaîne n'est pas au format ISO, elle est donc traitée comme un temps local. -<pre class="brush: js notranslate">Date.parse('Thu, 01 Jan 1970 00:00:00 GMT'); -</pre> +```js +Date.parse('Thu, 01 Jan 1970 00:00:00 GMT'); +``` -<p>Renvoie <code>0</code> quel que soit le fuseau local car l'indicateur GMT est fourni.</p> +Renvoie `0` quel que soit le fuseau local car l'indicateur GMT est fourni. -<pre class="brush: js notranslate">Date.parse('Thu, 01 Jan 1970 00:00:00'); -</pre> +```js +Date.parse('Thu, 01 Jan 1970 00:00:00'); +``` -<p>Renvoie <code>14400000</code> pour le fuseau GMT-0400 et d'autres valeurs dans d'autres fuseaux car aucune indication de fuseau n'est fournie et la chaîne n'est pas au format ISO, elle est donc traitée comme un temps local.</p> +Renvoie `14400000` pour le fuseau GMT-0400 et d'autres valeurs dans d'autres fuseaux car aucune indication de fuseau n'est fournie et la chaîne n'est pas au format ISO, elle est donc traitée comme un temps local. -<pre class="brush: js notranslate">Date.parse('Thu, 01 Jan 1970 00:00:00 GMT-0400'); -</pre> +```js +Date.parse('Thu, 01 Jan 1970 00:00:00 GMT-0400'); +``` -<p>Renvoie <code>14400000</code> quel que soit le fuseau car l'indicateur GMT est fourni.</p> +Renvoie `14400000` quel que soit le fuseau car l'indicateur GMT est fourni. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.4.2', 'Date.parse')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Ajout du format ISO 8601 simplifié.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.parse', 'Date.parse')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.parse', 'Date.parse')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.4.2', 'Date.parse')}} | {{Spec2('ES5.1')}} | Ajout du format ISO 8601 simplifié. | +| {{SpecName('ES6', '#sec-date.parse', 'Date.parse')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.parse', 'Date.parse')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.Date.parse")}}</p> +{{Compat("javascript.builtins.Date.parse")}} -<h2 id="Notes_de_compatibilité">Notes de compatibilité</h2> +## Notes de compatibilité -<ul> - <li>À partir de Firefox 49 ({{geckoRelease(49)}}, l'interprétation des années exprimées sur deux chiffres est alignée avec Google Chrome (et non plus avec Internet Explorer). Désormais, les années exprimées sur deux chiffres et strictement inférieures à 50 seront considérées comme des années du XXIe siècle. Ainsi, <code>04/16/17</code> correspondait avant au 16 avril 1917 et correspond désormais au 16 avril 2017. Cela évite des problèmes d'interopérabilité et d'ambiguïté et cette méthode est recommandée par le format ISO 8601 (cf. {{bug(1265136)}}).</li> - <li>Google Chrome acceptera une chaîne de caractères avec un nombre pour le paramètre <code>dateString</code>. Ainsi, si on exécute <code>!!Date.parse("42")</code> dans Firefox, on obtiendra <code>false</code> tandis que que Google Chrome donnera <code>true</code> car <code>"42"</code> sera interprété comme la date du premier janvier 2042.</li> -</ul> +- À partir de Firefox 49 ({{geckoRelease(49)}}, l'interprétation des années exprimées sur deux chiffres est alignée avec Google Chrome (et non plus avec Internet Explorer). Désormais, les années exprimées sur deux chiffres et strictement inférieures à 50 seront considérées comme des années du XXIe siècle. Ainsi, `04/16/17` correspondait avant au 16 avril 1917 et correspond désormais au 16 avril 2017. Cela évite des problèmes d'interopérabilité et d'ambiguïté et cette méthode est recommandée par le format ISO 8601 (cf. {{bug(1265136)}}). +- Google Chrome acceptera une chaîne de caractères avec un nombre pour le paramètre `dateString`. Ainsi, si on exécute `!!Date.parse("42")` dans Firefox, on obtiendra `false` tandis que que Google Chrome donnera `true` car `"42"` sera interprété comme la date du premier janvier 2042. -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("Date.UTC()")}}</li> -</ul> +- {{jsxref("Date.UTC()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setdate/index.md b/files/fr/web/javascript/reference/global_objects/date/setdate/index.md index 7091ece853..01ebb5094c 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setdate/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setdate/index.md @@ -10,86 +10,61 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setDate original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setDate --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setDate()</strong></code> définit le jour du mois (relatif au début du mois courant) pour une date donnée.</p> +La méthode **`setDate()`** définit le jour du mois (relatif au début du mois courant) pour une date donnée. -<div>{{EmbedInteractiveExample("pages/js/date-setdate.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setdate.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setDate(valeurJour)</pre> + dateObj.setDate(valeurJour) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurJour</code></dt> - <dd>Un entier représentant le jour du mois.</dd> -</dl> +- `valeurJour` + - : Un entier représentant le jour du mois. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 00:00:00 UTC et la date résultante (l'objet {{jsxref("Date")}} est également modifié).</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 00:00:00 UTC et la date résultante (l'objet {{jsxref("Date")}} est également modifié). -<h2 id="Description">Description</h2> +## Description -<p>Si la <code>valeurJour</code> est en dehors des limites du mois courant, <code>setDate()</code> mettra à jour l'objet<code> </code>{{jsxref("Date")}} en conséquence.</p> +Si la `valeurJour` est en dehors des limites du mois courant, `setDate()` mettra à jour l'objet` `{{jsxref("Date")}} en conséquence. -<p>Par exemple, si 0 est fourni pour <code>valeurJour</code>, la date sera défini sur le dernier jour du mois précédent.</p> +Par exemple, si 0 est fourni pour `valeurJour`, la date sera défini sur le dernier jour du mois précédent. -<p>Si on fournit un nombre négatif, la date sera déterminée à rebours à partir du dernier jour du mois précédent. Ainsi, avec -1, on obtiendrait la veille du dernier jour du mois précédent.</p> +Si on fournit un nombre négatif, la date sera déterminée à rebours à partir du dernier jour du mois précédent. Ainsi, avec -1, on obtiendrait la veille du dernier jour du mois précédent. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setDate()">Utiliser <code>setDate()</code></h3> +### Utiliser `setDate()` -<pre class="brush:js">var theBigDay = new Date(1962, 6, 7); // 1962-07-06T23:00:00.000Z +```js +var theBigDay = new Date(1962, 6, 7); // 1962-07-06T23:00:00.000Z theBigDay.setDate(24); // 1962-07-23T23:00:00.000Z theBigDay.setDate(32); // 1962-07-31T23:00:00.000Z theBigDay.setDate(22); // 1962-08-21T23:00:00.000Z theBigDay.setDate(0); // 1962-07-30T23:00:00.000Z theBigDay.setDate(98); // 1962-10-05T23:00:00.000Z -theBigDay.setDate(-50); // 1962-08-10T23:00:00.000Z</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.36', 'Date.prototype.setDate')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setDate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getDate()")}}</li> - <li>{{jsxref("Date.prototype.setUTCDate()")}}</li> -</ul> +theBigDay.setDate(-50); // 1962-08-10T23:00:00.000Z +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.36', 'Date.prototype.setDate')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setDate")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getDate()")}} +- {{jsxref("Date.prototype.setUTCDate()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setfullyear/index.md b/files/fr/web/javascript/reference/global_objects/date/setfullyear/index.md index 5c08f44347..c5ce1547e4 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setfullyear/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setfullyear/index.md @@ -10,85 +10,59 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setFullYear original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setFullYear --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setFullYear()</strong></code> définit l'année complête pour une date, d'après l'heure locale.</p> +La méthode **`setFullYear()`** définit l'année complête pour une date, d'après l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-setfullyear.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setfullyear.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setFullYear(valeurAnnée[, valeurMois[, valeurJour]])</pre> + dateObj.setFullYear(valeurAnnée[, valeurMois[, valeurJour]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurAnnée</code></dt> - <dd>Un entier indiquant la valeur numérique de l'année, par exemple, 1995.</dd> - <dt><code>valeurMois</code></dt> - <dd>Paramètre optionnel qui représente un entier entre 0 et 11, représentant les mois de janvier à décembre.</dd> - <dt><code>valeurJour</code></dt> - <dd>Paramètre optionnel qui représente un entier entre 1 et 31 représentant le jour du mois. Si vous indiquez une <code>valeurJour</code>, vous devez aussi indiquer <code>valeurMois</code>.</dd> -</dl> +- `valeurAnnée` + - : Un entier indiquant la valeur numérique de l'année, par exemple, 1995. +- `valeurMois` + - : Paramètre optionnel qui représente un entier entre 0 et 11, représentant les mois de janvier à décembre. +- `valeurJour` + - : Paramètre optionnel qui représente un entier entre 1 et 31 représentant le jour du mois. Si vous indiquez une `valeurJour`, vous devez aussi indiquer `valeurMois`. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si vous n'indiquez pas les paramètres <code>valeurMois</code> et <code>valeurJour</code>. Les valeurs renvoyées par les méthodes {{jsxref("Date.prototype.getMonth()", "getMonth()")}} et {{jsxref("Date.prototype.getDate()", "getDate()")}} seront utilisées.</p> +Si vous n'indiquez pas les paramètres `valeurMois` et `valeurJour`. Les valeurs renvoyées par les méthodes {{jsxref("Date.prototype.getMonth()", "getMonth()")}} et {{jsxref("Date.prototype.getDate()", "getDate()")}} seront utilisées. -<p>Si un des paramètres que vous indiquez est en dehors des limites attendues, <code>setFullYear()</code> tentera de mettre à jour la date en conséquence. Pa exemple, si vous indiquez 15 pour <code>valeurMois</code>, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois.</p> +Si un des paramètres que vous indiquez est en dehors des limites attendues, `setFullYear()` tentera de mettre à jour la date en conséquence. Pa exemple, si vous indiquez 15 pour `valeurMois`, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setFullYear()">Utiliser <code>setFullYear()</code></h3> +### Utiliser `setFullYear()` -<pre class="brush:js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setFullYear(1997); -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</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-15.9.5.40', 'Date.prototype.setFullYear')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setfullyear', 'Date.prototype.setFullYear')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setfullyear', 'Date.prototype.setFullYear')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setFullYear")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> - <li>{{jsxref("Date.prototype.setUTCFullYear()")}}</li> - <li>{{jsxref("Date.prototype.setYear()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.40', 'Date.prototype.setFullYear')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setfullyear', 'Date.prototype.setFullYear')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setfullyear', 'Date.prototype.setFullYear')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setFullYear")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCFullYear()")}} +- {{jsxref("Date.prototype.setUTCFullYear()")}} +- {{jsxref("Date.prototype.setYear()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/sethours/index.md b/files/fr/web/javascript/reference/global_objects/date/sethours/index.md index a2823e19d0..0571dbdf8b 100644 --- a/files/fr/web/javascript/reference/global_objects/date/sethours/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/sethours/index.md @@ -10,91 +10,64 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setHours original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setHours --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setHours()</strong></code> définit les heures pour une date donnée, selon l'heure locale, et renvoie le nombre de millièmes de secondes écoulées entre le 1er janvier 1970 00:00:00 UTC et la nouvelle date mise à jour.</p> +La méthode **`setHours()`** définit les heures pour une date donnée, selon l'heure locale, et renvoie le nombre de millièmes de secondes écoulées entre le 1er janvier 1970 00:00:00 UTC et la nouvelle date mise à jour. -<div>{{EmbedInteractiveExample("pages/js/date-sethours.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-sethours.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">dateObj.setHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]]) -</pre> + dateObj.setHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]]) -<h3 id="Versions_antérieures_à_JavaScript_1.3">Versions antérieures à JavaScript 1.3</h3> +### Versions antérieures à JavaScript 1.3 -<pre class="syntaxbox">dateObj.setHours(valeurHeures)</pre> + dateObj.setHours(valeurHeures) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurHeures</code></dt> - <dd>Un entier normalement compris entre 0 et 23, représentant l'heure. Si la valeur est supérieure à 23, la valeur de l'heure sera incrémentée d'autant d'heures supplémentaires.</dd> - <dt><code>valeurMinutes</code></dt> - <dd>Paramètre optionnel, un entier normalement compris entre 0 et 59, représentant les minutes. Si la valeur est supérieure à 59, la valeur de l'heure sera incrémentée d'autant de minutes supplémentaires.</dd> - <dt><code>valeurSecondes</code></dt> - <dd>Paramètre optionnel, un entier normalement compris entre 0 et 59, représentant les secondes. Si vous indiquez le paramètre <code>valeurSecondes</code>, vous devez aussi renseigner <code>valeurMinutes</code>. Si la valeur est supérieure à 59, l'heure sera incrémentée d'autant de secondes supplémentaires.</dd> - <dt><code>valeurMs</code></dt> - <dd>Paramètre optionnel, un entier normalement compris entre 0 et 999, représentant les millièmes de secondes. Si vous indiquez <code>valeurMs</code>, vous devez aussi renseigner <code>valeurMinutes</code> et <code>valeurSecondes</code>. Si la valeur fournie est supérieure à 999, l'heure sera incrémentée d'autant de millisecondes supplémentaires.</dd> -</dl> +- `valeurHeures` + - : Un entier normalement compris entre 0 et 23, représentant l'heure. Si la valeur est supérieure à 23, la valeur de l'heure sera incrémentée d'autant d'heures supplémentaires. +- `valeurMinutes` + - : Paramètre optionnel, un entier normalement compris entre 0 et 59, représentant les minutes. Si la valeur est supérieure à 59, la valeur de l'heure sera incrémentée d'autant de minutes supplémentaires. +- `valeurSecondes` + - : Paramètre optionnel, un entier normalement compris entre 0 et 59, représentant les secondes. Si vous indiquez le paramètre `valeurSecondes`, vous devez aussi renseigner `valeurMinutes`. Si la valeur est supérieure à 59, l'heure sera incrémentée d'autant de secondes supplémentaires. +- `valeurMs` + - : Paramètre optionnel, un entier normalement compris entre 0 et 999, représentant les millièmes de secondes. Si vous indiquez `valeurMs`, vous devez aussi renseigner `valeurMinutes` et `valeurSecondes`. Si la valeur fournie est supérieure à 999, l'heure sera incrémentée d'autant de millisecondes supplémentaires. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si vous ne renseignez pas <code>valeurMinutes</code>, <code>valeurSecondes</code> et <code>valeurMs</code>, les valeurs renvoyées par les méthodes {{jsxref("Date.getMinutes", "getMinutes()")}}, {{jsxref("Date.getSeconds", "getSeconds()")}}, et {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} seront utilisées.</p> +Si vous ne renseignez pas `valeurMinutes`, `valeurSecondes` et `valeurMs`, les valeurs renvoyées par les méthodes {{jsxref("Date.getMinutes", "getMinutes()")}}, {{jsxref("Date.getSeconds", "getSeconds()")}}, et {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} seront utilisées. -<p>Si un des paramètres que vous renseignez est en dehors des limites attendues, <code>setHours()</code> tentera de mettre à jour la date en conséquence. Par exemple, si vous utilisez 100 pour <code>valeurSecondes</code>, les minutes seront incrémentées de 1 (min + 1), et 40 sera utilisé pour les secondes.</p> +Si un des paramètres que vous renseignez est en dehors des limites attendues, `setHours()` tentera de mettre à jour la date en conséquence. Par exemple, si vous utilisez 100 pour `valeurSecondes`, les minutes seront incrémentées de 1 (min + 1), et 40 sera utilisé pour les secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setHours()">Utiliser <code>setHours()</code></h3> +### Utiliser `setHours()` -<pre class="brush:js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setHours(7); -</pre> - -<h2 id="Spécifications">Spécifications</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.0</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.34', 'Date.prototype.setHours')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.sethours', 'Date.prototype.setHours')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.sethours', 'Date.prototype.setHours')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setHours")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getHours()")}}</li> - <li>{{jsxref("Date.prototype.setUTCHours()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ---------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0 | +| {{SpecName('ES5.1', '#sec-15.9.5.34', 'Date.prototype.setHours')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.sethours', 'Date.prototype.setHours')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.sethours', 'Date.prototype.setHours')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setHours")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getHours()")}} +- {{jsxref("Date.prototype.setUTCHours()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setmilliseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/setmilliseconds/index.md index 472eb7e43e..e6ab186569 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setmilliseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setmilliseconds/index.md @@ -10,78 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMilliseconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setMilliseconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setMilliseconds()</strong></code> définit les millièmes de secondes pour la date, selon l'heure locale.</p> +La méthode **`setMilliseconds()`** définit les millièmes de secondes pour la date, selon l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-setmilliseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setmilliseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setMilliseconds(valeurMs)</pre> + dateObj.setMilliseconds(valeurMs) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurMs</code></dt> - <dd>Un entier entre 0 et 999, représentant les millièmes de secondes.</dd> -</dl> +- `valeurMs` + - : Un entier entre 0 et 999, représentant les millièmes de secondes. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si vous indiquez un nombre en dehors des limites attendues, la date sera mise à jour en conséquence. Par exemple, si vous indiquez 1005, le nombre des secondes sera incrémenté de 1, et 5 sera utilisé pour les millièmes de secondes.</p> +Si vous indiquez un nombre en dehors des limites attendues, la date sera mise à jour en conséquence. Par exemple, si vous indiquez 1005, le nombre des secondes sera incrémenté de 1, et 5 sera utilisé pour les millièmes de secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setMilliseconds()">Utiliser <code>setMilliseconds()</code></h3> +### Utiliser `setMilliseconds()` -<pre class="brush:js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setMilliseconds(100); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.28', 'Date.prototype.setMilliseconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setmilliseconds', 'Date.prototype.setMilliseconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setmilliseconds', 'Date.prototype.setMilliseconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setMilliseconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getMilliseconds()")}}</li> - <li>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.28', 'Date.prototype.setMilliseconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setmilliseconds', 'Date.prototype.setMilliseconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setmilliseconds', 'Date.prototype.setMilliseconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setMilliseconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getMilliseconds()")}} +- {{jsxref("Date.prototype.setUTCMilliseconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setminutes/index.md b/files/fr/web/javascript/reference/global_objects/date/setminutes/index.md index dfed490684..894474edac 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setminutes/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setminutes/index.md @@ -10,88 +10,62 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMinutes original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setMinutes --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setMinutes()</strong></code> définit les minutes pour la date donnée, selon l'heure locale.</p> +La méthode **`setMinutes()`** définit les minutes pour la date donnée, selon l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-setminutes.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setminutes.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setMinutes(valeurMinutes[, valeurSecondes[, valeurMs]])</pre> + dateObj.setMinutes(valeurMinutes[, valeurSecondes[, valeurMs]]) -<h3 id="Versions_antérieures_à_JavaScript_1.3">Versions antérieures à JavaScript 1.3</h3> +### Versions antérieures à JavaScript 1.3 -<pre class="syntaxbox"><var>dateObj</var>.setMinutes(valeurMinutes)</pre> + dateObj.setMinutes(valeurMinutes) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurMinutes</code></dt> - <dd>Un entier entre 0 et 59, représentant les minutes.</dd> - <dt><code>valeurSecondes</code></dt> - <dd>Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si <code>valeurSecondes</code> est utilisé, il faut également utiliser <code>valeurMinutes</code>.</dd> - <dt><code>valeurMs</code></dt> - <dd>Paramètre optionel, un nombre entre 0 et 999, représentant les millièmes de secondes. Si <code>valeurMs</code> est utilisé, il faut également utiliser <code>valeurMinutes</code> et <code>valeurSecondes</code>.</dd> -</dl> +- `valeurMinutes` + - : Un entier entre 0 et 59, représentant les minutes. +- `valeurSecondes` + - : Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si `valeurSecondes` est utilisé, il faut également utiliser `valeurMinutes`. +- `valeurMs` + - : Paramètre optionel, un nombre entre 0 et 999, représentant les millièmes de secondes. Si `valeurMs` est utilisé, il faut également utiliser `valeurMinutes` et `valeurSecondes`. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si <code>valeurSecondes</code> et <code>valeurMs</code> ne sont pas indiquées, les valeurs renvoyées par les méthodes {{jsxref("Date.getSeconds", "getSeconds()")}} et {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} seront utilisées.</p> +Si `valeurSecondes` et `valeurMs` ne sont pas indiquées, les valeurs renvoyées par les méthodes {{jsxref("Date.getSeconds", "getSeconds()")}} et {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} seront utilisées. -<p>Si un paramètre est en dehors des limites attendues, <code>setMinutes()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour <code>valeurSecondes</code>, les minutes (<code>valeurMinutes</code>) seront incrémentées de 1 (<code>valeurMinutes</code> + 1), et 40 sera utilisé pour les secondes.</p> +Si un paramètre est en dehors des limites attendues, `setMinutes()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour `valeurSecondes`, les minutes (`valeurMinutes`) seront incrémentées de 1 (`valeurMinutes` + 1), et 40 sera utilisé pour les secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setMinutes()">Utiliser <code>setMinutes()</code></h3> +### Utiliser `setMinutes()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setMinutes(45); -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.32', 'Date.prototype.setMinutes')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setminutes', 'Date.prototype.setMinutes')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setminutes', 'Date.prototype.setMinutes')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setMinutes")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getMinutes()")}}</li> - <li>{{jsxref("Date.prototype.setUTCMinutes()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.32', 'Date.prototype.setMinutes')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setminutes', 'Date.prototype.setMinutes')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setminutes', 'Date.prototype.setMinutes')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setMinutes")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getMinutes()")}} +- {{jsxref("Date.prototype.setUTCMinutes()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setmonth/index.md b/files/fr/web/javascript/reference/global_objects/date/setmonth/index.md index 08e81440aa..adaccb768d 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setmonth/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setmonth/index.md @@ -10,95 +10,69 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMonth original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setMonth --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setMonth()</strong></code> définit le mois de la date, selon l'heure locale et l'année courante de l'objet {{jsxref("Date")}}</p> +La méthode **`setMonth()`** définit le mois de la date, selon l'heure locale et l'année courante de l'objet {{jsxref("Date")}} -<div>{{EmbedInteractiveExample("pages/js/date-setmonth.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setmonth.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setMonth(valeurMois[, valeurJour])</pre> + dateObj.setMonth(valeurMois[, valeurJour]) -<h3 id="Versions_antérieures_à_JavaScript_1.3">Versions antérieures à JavaScript 1.3</h3> +### Versions antérieures à JavaScript 1.3 -<pre class="syntaxbox"><var>dateObj</var>.setMonth(valeurMois)</pre> + dateObj.setMonth(valeurMois) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurMois</code></dt> - <dd>Un entier entre 0 et 11 (représentant les mois de janvier à décembre).</dd> - <dt><code>valeurJour</code></dt> - <dd>Paramètre optionnel, un entier entre 1 et 31, représentant le jour du mois.</dd> -</dl> +- `valeurMois` + - : Un entier entre 0 et 11 (représentant les mois de janvier à décembre). +- `valeurJour` + - : Paramètre optionnel, un entier entre 1 et 31, représentant le jour du mois. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si le paramètre <code>valeurJour</code> n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getDate", "getDate()")}} sera utilisée.</p> +Si le paramètre `valeurJour` n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getDate", "getDate()")}} sera utilisée. -<p>Si un paramètre que vous renseignez n'est pas dans les limites attendues, <code>setMonth()</code> tentera de mettre à jour la date en conséquence. Par exemple, si la valeur 15 est utilisée pour <code>valeurMois</code>, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois.</p> +Si un paramètre que vous renseignez n'est pas dans les limites attendues, `setMonth()` tentera de mettre à jour la date en conséquence. Par exemple, si la valeur 15 est utilisée pour `valeurMois`, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois. -<div class="note"> -<p><strong>Note :</strong> Attention aux jours du mois lorsqu'on utilise <code>setMonth()</code>. En effet, <code>setMonth()</code> cherchera à aboutir à une date correcte et on peut avoir des surprises pour les transitions entre les mois. Ainsi, en 2016 (où février a eu 29 jours), on aura le cas suivant :</p> +> **Note :** Attention aux jours du mois lorsqu'on utilise `setMonth()`. En effet, `setMonth()` cherchera à aboutir à une date correcte et on peut avoir des surprises pour les transitions entre les mois. Ainsi, en 2016 (où février a eu 29 jours), on aura le cas suivant : +> +> ```js +> var finDuMois = new Date(2016, 7, 31); // le 31 août 2016 +> finDuMois.setMonth(1); +> +> console.log(finDuMois.toLocaleString()); // 02/03/2016 à 00:00:00 +> ``` -<pre class="brush: js">var finDuMois = new Date(2016, 7, 31); // le 31 août 2016 -finDuMois.setMonth(1); +## Exemples -console.log(finDuMois.toLocaleString()); // 02/03/2016 à 00:00:00</pre> -</div> +### Utiliser `setMonth()` -<h2 id="Exemples">Exemples</h2> +```js +var leGrandJour = new Date(); +leGrandJour.setMonth(6); +``` -<h3 id="Utiliser_setMonth()">Utiliser <code>setMonth()</code></h3> +## Spécifications -<pre class="brush: js">var leGrandJour = new Date(); -leGrandJour.setMonth(6); -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.38', 'Date.prototype.setMonth')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setMonth")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getMonth()")}}</li> - <li>{{jsxref("Date.prototype.setUTCMonth()")}}</li> -</ul> +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.38', 'Date.prototype.setMonth')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setMonth")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getMonth()")}} +- {{jsxref("Date.prototype.setUTCMonth()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/setseconds/index.md index b979885ed8..b6db54ba85 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setseconds/index.md @@ -10,86 +10,60 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setSeconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setSeconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setSeconds()</strong></code> définit les secondes pour la date, selon l'heure locale.</p> +La méthode **`setSeconds()`** définit les secondes pour la date, selon l'heure locale. -<div>{{EmbedInteractiveExample("pages/js/date-setseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setSeconds(valeurSecondes[, valeurMs])</pre> + dateObj.setSeconds(valeurSecondes[, valeurMs]) -<h3 id="Versions_antérieures_à_JavaScript_1.3">Versions antérieures à JavaScript 1.3</h3> +### Versions antérieures à JavaScript 1.3 -<pre class="syntaxbox"><var>dateObj</var>.setSeconds(valeurSecondes)</pre> + dateObj.setSeconds(valeurSecondes) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurSecondes</code></dt> - <dd>Un entier entre 0 et 59.</dd> - <dt><code>valeurMs</code></dt> - <dd>Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes.</dd> -</dl> +- `valeurSecondes` + - : Un entier entre 0 et 59. +- `valeurMs` + - : Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si le paramètre <code>valeurMs</code> n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} sera utilisée.</p> +Si le paramètre `valeurMs` n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} sera utilisée. -<p>Si un paramètre utilisé est en dehors des limites attendues, <code>setSeconds()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour <code>valeurSecondes</code>, les minutes de la date seront incrémentées de 1, et 40 sera utilisé pour les secondes.</p> +Si un paramètre utilisé est en dehors des limites attendues, `setSeconds()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour `valeurSecondes`, les minutes de la date seront incrémentées de 1, et 40 sera utilisé pour les secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setSeconds()">Utiliser <code>setSeconds()</code></h3> +### Utiliser `setSeconds()` -<pre class="brush:js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setSeconds(30) -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.30', 'Date.prototype.setSeconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setseconds', 'Date.prototype.setSeconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setseconds', 'Date.prototype.setSeconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setSeconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getSeconds()")}}</li> - <li>{{jsxref("Date.prototype.setUTCSeconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.30', 'Date.prototype.setSeconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setseconds', 'Date.prototype.setSeconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setseconds', 'Date.prototype.setSeconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setSeconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getSeconds()")}} +- {{jsxref("Date.prototype.setUTCSeconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/settime/index.md b/files/fr/web/javascript/reference/global_objects/date/settime/index.md index 4318c595b4..01c26769a9 100644 --- a/files/fr/web/javascript/reference/global_objects/date/settime/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/settime/index.md @@ -10,79 +10,53 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setTime original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setTime --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setTime()</strong></code> met l'objet {{jsxref("Date")}} à jour par rapport au nombre de millisecondes depuis le 1 janvier 1970, 00:00:00 UTC.</p> +La méthode **`setTime()`** met l'objet {{jsxref("Date")}} à jour par rapport au nombre de millisecondes depuis le 1 janvier 1970, 00:00:00 UTC. -<div>{{EmbedInteractiveExample("pages/js/date-settime.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-settime.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setTime(valeurTemps)</pre> + dateObj.setTime(valeurTemps) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurTemps</code></dt> - <dd>Un entier représentant le nombre de millisecondes depuis le 1 janvier 1970, 00:00:00 UTC.</dd> -</dl> +- `valeurTemps` + - : Un entier représentant le nombre de millisecondes depuis le 1 janvier 1970, 00:00:00 UTC. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, UTC et la date mise à jour (ce qui correspond à la valeur de l'argument).</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, UTC et la date mise à jour (ce qui correspond à la valeur de l'argument). -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>setTime()</code> est utilisée afin d'assigner une date à un autre objet {{jsxref("Date")}}.</p> +La méthode `setTime()` est utilisée afin d'assigner une date à un autre objet {{jsxref("Date")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setTime()">Utiliser <code>setTime()</code></h3> +### Utiliser `setTime()` -<pre class="brush: js">var leGrandJour = new Date("July 1, 1999"); +```js +var leGrandJour = new Date("July 1, 1999"); var pareilQueGrandJour = new Date(); pareilQueGrandJour.setTime(leGrandJour.getTime()); -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.27', 'Date.prototype.setTime')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.settime', 'Date.prototype.setTime')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.settime', 'Date.prototype.setTime')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setTime")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getTime()")}}</li> - <li>{{jsxref("Date.prototype.setUTCHours()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.27', 'Date.prototype.setTime')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.settime', 'Date.prototype.setTime')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.settime', 'Date.prototype.setTime')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setTime")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getTime()")}} +- {{jsxref("Date.prototype.setUTCHours()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutcdate/index.md b/files/fr/web/javascript/reference/global_objects/date/setutcdate/index.md index 98de0005b5..b2b6aa67a4 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutcdate/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutcdate/index.md @@ -10,78 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCDate original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCDate --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCDate()</strong></code> définit le jour du mois pour la date, selon UTC.</p> +La méthode **`setUTCDate()`** définit le jour du mois pour la date, selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-setutcdate.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutcdate.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCDate(valeurJour)</pre> + dateObj.setUTCDate(valeurJour) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurJour</code></dt> - <dd>Un entier de 1 à 31, représentant un jour dans le mois.</dd> -</dl> +- `valeurJour` + - : Un entier de 1 à 31, représentant un jour dans le mois. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si le paramètre renseigné est en dehors des limites attendues, <code>setUTCDate()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 40 pour <code>valeurJour</code>, et que le mois de la date est juin, le jour sera changé en 10 et le mois passera à juillet.</p> +Si le paramètre renseigné est en dehors des limites attendues, `setUTCDate()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 40 pour `valeurJour`, et que le mois de la date est juin, le jour sera changé en 10 et le mois passera à juillet. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCDate()">Utiliser <code>setUTCDate()</code></h3> +### Utiliser `setUTCDate()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCDate(20); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.37', 'Date.prototype.setUTCDate')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutcdate', 'Date.prototype.setUTCDate')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcdate', 'Date.prototype.setUTCDate')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCDate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> - <li>{{jsxref("Date.prototype.setDate()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.37', 'Date.prototype.setUTCDate')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutcdate', 'Date.prototype.setUTCDate')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutcdate', 'Date.prototype.setUTCDate')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCDate")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCDate()")}} +- {{jsxref("Date.prototype.setDate()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutcfullyear/index.md b/files/fr/web/javascript/reference/global_objects/date/setutcfullyear/index.md index beeedfb099..4490cf9d6a 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutcfullyear/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutcfullyear/index.md @@ -10,84 +10,58 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCFullYear original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCFullYear --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCFullYear()</strong></code> définit l'année complête pour la date, selon UTC.</p> +La méthode **`setUTCFullYear()`** définit l'année complête pour la date, selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-setutcfullyear.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutcfullyear.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCFullYear(valeurAnnée[, valeurMois[, valeurJour]])</pre> + dateObj.setUTCFullYear(valeurAnnée[, valeurMois[, valeurJour]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurAnnée</code></dt> - <dd>Un entier indiquant la valeur numérique d'une année, par exemple, 1995.</dd> - <dt><code>valeurMois</code></dt> - <dd>Paramètre optionnel, un entier entre 0 et 11 représentant les mois de janvier à décembre.</dd> - <dt><code>valeurJour</code></dt> - <dd>Paramètre optionnel, un entier entre 1 et 31 représentant le jour du mois. Si le paramètre <code>valeurJour</code> est utilisé, il est également nécessaire d'indiquer <code>valeurMois</code>.</dd> -</dl> +- `valeurAnnée` + - : Un entier indiquant la valeur numérique d'une année, par exemple, 1995. +- `valeurMois` + - : Paramètre optionnel, un entier entre 0 et 11 représentant les mois de janvier à décembre. +- `valeurJour` + - : Paramètre optionnel, un entier entre 1 et 31 représentant le jour du mois. Si le paramètre `valeurJour` est utilisé, il est également nécessaire d'indiquer `valeurMois`. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si les paramètres <code>valeurMois</code> et <code>valeurJour</code> ne sont pas utilisés, les valeurs renvoyées par les méthodes {{jsxref("Objets_globaux/Date/getUTCMonth", "getUTCMonth()")}} et {{jsxref("Objets_globaux/Date/getUTCDate", "getUTCDate()")}} seront utilisées.</p> +Si les paramètres `valeurMois` et `valeurJour` ne sont pas utilisés, les valeurs renvoyées par les méthodes {{jsxref("Objets_globaux/Date/getUTCMonth", "getUTCMonth()")}} et {{jsxref("Objets_globaux/Date/getUTCDate", "getUTCDate()")}} seront utilisées. -<p>Si un des paramètres indiqué est en dehors des limites attendues, <code>setUTCFullYear()</code> tentera de mettre à jour la date en conséquence. Ainsi si on utilise la valeur 15 pour <code>valeurMois</code>, l'année sera incrémentée de 1 (année + 1), et 3 sera utilisé pour le mois.</p> +Si un des paramètres indiqué est en dehors des limites attendues, `setUTCFullYear()` tentera de mettre à jour la date en conséquence. Ainsi si on utilise la valeur 15 pour `valeurMois`, l'année sera incrémentée de 1 (année + 1), et 3 sera utilisé pour le mois. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCFullYear()">Utiliser <code>setUTCFullYear()</code></h3> +### Utiliser `setUTCFullYear()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCFullYear(1997); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.41', 'Date.prototype.setUTCFullYear')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutcfullyear', 'Date.prototype.setUTCFullYear')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcfullyear', 'Date.prototype.setUTCFullYear')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCFullYear")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> - <li>{{jsxref("Date.prototype.setFullYear()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.41', 'Date.prototype.setUTCFullYear')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutcfullyear', 'Date.prototype.setUTCFullYear')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutcfullyear', 'Date.prototype.setUTCFullYear')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCFullYear")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCFullYear()")}} +- {{jsxref("Date.prototype.setFullYear()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutchours/index.md b/files/fr/web/javascript/reference/global_objects/date/setutchours/index.md index 038f330691..775990f78e 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutchours/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutchours/index.md @@ -10,86 +10,60 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCHours original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCHours --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCHours()</strong></code> définit les heures pour la date, selon UTC, et renvoie le nombre de millièmes de secondes écoulées entre le 1er janvier 1970 00:00:00 UTC et cette nouvelle date.</p> +La méthode **`setUTCHours()`** définit les heures pour la date, selon UTC, et renvoie le nombre de millièmes de secondes écoulées entre le 1er janvier 1970 00:00:00 UTC et cette nouvelle date. -<div>{{EmbedInteractiveExample("pages/js/date-setutchours.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutchours.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]])</pre> + dateObj.setUTCHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurHeures</code></dt> - <dd>Un entier entre 0 et 23, représentant l'heure.</dd> - <dt><code>valeurMinutes</code></dt> - <dd>Paramètre optionnel, un entier entre 0 et 59, représentant les minutes.</dd> - <dt><code>valeurSecondes</code></dt> - <dd>Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si le paramètre <code>valeurSecondes</code> est utilisé, le paramètre <code>valeurMinutes</code> devra également être renseigné.</dd> - <dt><code>valeurMs</code></dt> - <dd>Paramètre optionnel, un entier entre 0 et 999, représentant les millièmes de secondes. Si le paramètre <code>valeurMs</code> est utilisé, les paramètres <code>valeurMinutes</code> et <code>valeurSecondes</code> devront également être renseignés.</dd> -</dl> +- `valeurHeures` + - : Un entier entre 0 et 23, représentant l'heure. +- `valeurMinutes` + - : Paramètre optionnel, un entier entre 0 et 59, représentant les minutes. +- `valeurSecondes` + - : Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si le paramètre `valeurSecondes` est utilisé, le paramètre `valeurMinutes` devra également être renseigné. +- `valeurMs` + - : Paramètre optionnel, un entier entre 0 et 999, représentant les millièmes de secondes. Si le paramètre `valeurMs` est utilisé, les paramètres `valeurMinutes` et `valeurSecondes` devront également être renseignés. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si les paramètres <code>valeurMinutes</code>, <code>valeurSecondes</code> et <code>valeurMs</code> ne sont pas renseignés, les valeurs renvoyées par les méthodes {{jsxref("Date.prototype.getUTCMinutes", "getUTCMinutes()")}}, {{jsxref("Date.prototype.getUTCSeconds", "getUTCSeconds()")}}, et {{jsxref("Date.prototype.getUTCMilliseconds", "getUTCMilliseconds()")}} seront utilisées.</p> +Si les paramètres `valeurMinutes`, `valeurSecondes` et `valeurMs` ne sont pas renseignés, les valeurs renvoyées par les méthodes {{jsxref("Date.prototype.getUTCMinutes", "getUTCMinutes()")}}, {{jsxref("Date.prototype.getUTCSeconds", "getUTCSeconds()")}}, et {{jsxref("Date.prototype.getUTCMilliseconds", "getUTCMilliseconds()")}} seront utilisées. -<p>Si un des paramètres renseignés est en dehors des limites attendues, <code>setUTCHours()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour <code>valeurSecondes</code>, les minutes seront incrémentées de 1 (min + 1), et 40 sera utilisé pour les secondes.</p> +Si un des paramètres renseignés est en dehors des limites attendues, `setUTCHours()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour `valeurSecondes`, les minutes seront incrémentées de 1 (min + 1), et 40 sera utilisé pour les secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCHours()">Utiliser <code>setUTCHours()</code></h3> +### Utiliser `setUTCHours()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCHours(8); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.35', 'Date.prototype.setUTCHours')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutchours', 'Date.prototype.setUTCHours')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutchours', 'Date.prototype.setUTCHours')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCHours")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCHours()")}}</li> - <li>{{jsxref("Date.prototype.setHours()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.35', 'Date.prototype.setUTCHours')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutchours', 'Date.prototype.setUTCHours')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutchours', 'Date.prototype.setUTCHours')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCHours")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCHours()")}} +- {{jsxref("Date.prototype.setHours()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutcmilliseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/setutcmilliseconds/index.md index 4e6b3e26f1..7e7e0a4e3d 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutcmilliseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutcmilliseconds/index.md @@ -10,78 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMilliseconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCMilliseconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCMilliseconds()</strong></code> définit les millièmes de secondes pour la date, selon UTC.</p> +La méthode **`setUTCMilliseconds()`** définit les millièmes de secondes pour la date, selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-setutcmilliseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutcmilliseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCMilliseconds(valeurMs) </pre> + dateObj.setUTCMilliseconds(valeurMs) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurMs</code></dt> - <dd>Un entier entre 0 et 999, représentant les millièmes de secondes.</dd> -</dl> +- `valeurMs` + - : Un entier entre 0 et 999, représentant les millièmes de secondes. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si le paramètre indiqué est en dehors des limites attendues, la date sera mise à jour en conséquence. Par exemple, si on utilise la valeur 1005, le nombre des secondes sera incrémenté de 1, et 5 sera utilisé pour les millièmes de secondes.</p> +Si le paramètre indiqué est en dehors des limites attendues, la date sera mise à jour en conséquence. Par exemple, si on utilise la valeur 1005, le nombre des secondes sera incrémenté de 1, et 5 sera utilisé pour les millièmes de secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCMilliseconds()">Utiliser <code>setUTCMilliseconds()</code></h3> +### Utiliser `setUTCMilliseconds()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCMilliseconds(500); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.29', 'Date.prototype.setUTCMilliseconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCMilliseconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</li> - <li>{{jsxref("Date.prototype.setMilliseconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.29', 'Date.prototype.setUTCMilliseconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCMilliseconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCMilliseconds()")}} +- {{jsxref("Date.prototype.setMilliseconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutcminutes/index.md b/files/fr/web/javascript/reference/global_objects/date/setutcminutes/index.md index 5e57b4e761..ebf0a4ead5 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutcminutes/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutcminutes/index.md @@ -10,84 +10,58 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMinutes original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCMinutes --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCMinutes()</strong></code> définit les minutes pour la date, selon UTC.</p> +La méthode **`setUTCMinutes()`** définit les minutes pour la date, selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-setutcminutes.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutcminutes.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCMinutes(valeurMinutes[, valeurSecondes[, valeurMs]]) </pre> + dateObj.setUTCMinutes(valeurMinutes[, valeurSecondes[, valeurMs]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurMinutes</code></dt> - <dd>Un entier entre 0 et 59, représentant les minutes.</dd> - <dt><code>valeurSecondes</code></dt> - <dd>Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si ce paramètre est utilisé, il faut également utiliser <code>valeurMinutes</code>.</dd> - <dt><code>valeurMs</code></dt> - <dd>Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes. Si ce paramètre est utilisé, il faut aussi indiquer <code>valeurMinutes</code> et <code>valeurSecondes</code>.</dd> -</dl> +- `valeurMinutes` + - : Un entier entre 0 et 59, représentant les minutes. +- `valeurSecondes` + - : Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si ce paramètre est utilisé, il faut également utiliser `valeurMinutes`. +- `valeurMs` + - : Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes. Si ce paramètre est utilisé, il faut aussi indiquer `valeurMinutes` et `valeurSecondes`. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si les paramètres <code>valeurSecondes</code> et <code>valeurMs</code> ne sont pas utilisés, les valeurs renvoyées par les méthodes {{jsxref("Date.prototype.getUTCSeconds", "getUTCSeconds()")}} et {{jsxref("Date.prototype.getUTCMilliseconds", "getUTCMilliseconds()")}} seront utilisées.</p> +Si les paramètres `valeurSecondes` et `valeurMs` ne sont pas utilisés, les valeurs renvoyées par les méthodes {{jsxref("Date.prototype.getUTCSeconds", "getUTCSeconds()")}} et {{jsxref("Date.prototype.getUTCMilliseconds", "getUTCMilliseconds()")}} seront utilisées. -<p>Si un paramètre est en dehors des limites attendues, <code>setUTCMinutes()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise 100 pour <code>valeurSecondes</code>, les minutes (<code>valeurMinutes</code>) seront incrémentées de 1 (<code>valeurMinutes</code> + 1), et 40 sera utilisé pour les secondes.</p> +Si un paramètre est en dehors des limites attendues, `setUTCMinutes()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise 100 pour `valeurSecondes`, les minutes (`valeurMinutes`) seront incrémentées de 1 (`valeurMinutes` + 1), et 40 sera utilisé pour les secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCMinutes()">Utiliser <code>setUTCMinutes()</code></h3> +### Utiliser `setUTCMinutes()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCMinutes(43); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.33', 'Date.prototype.setUTCMinutes')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutcminutes', 'Date.prototype.setUTCMinutes')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcminutes', 'Date.prototype.setUTCMinutes')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCMinutes")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCMinutes()")}}</li> - <li>{{jsxref("Date.prototype.setMinutes()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.33', 'Date.prototype.setUTCMinutes')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutcminutes', 'Date.prototype.setUTCMinutes')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutcminutes', 'Date.prototype.setUTCMinutes')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCMinutes")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCMinutes()")}} +- {{jsxref("Date.prototype.setMinutes()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutcmonth/index.md b/files/fr/web/javascript/reference/global_objects/date/setutcmonth/index.md index 7fff322429..580acfb674 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutcmonth/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutcmonth/index.md @@ -10,82 +10,56 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMonth original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCMonth --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCMonth()</strong></code> définit le mois de la date, selon UTC.</p> +La méthode **`setUTCMonth()`** définit le mois de la date, selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-setutcmonth.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutcmonth.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCMonth(valeurMois[, valeurJour]) </pre> + dateObj.setUTCMonth(valeurMois[, valeurJour]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurMois</code></dt> - <dd>Un entier entre 0 et 11, représentant les mois de Janvier à Décembre.</dd> - <dt><code>valeurJour</code></dt> - <dd>Paramètre optionnel, un entier entre 1 et 31, représentant le jour du mois.</dd> -</dl> +- `valeurMois` + - : Un entier entre 0 et 11, représentant les mois de Janvier à Décembre. +- `valeurJour` + - : Paramètre optionnel, un entier entre 1 et 31, représentant le jour du mois. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si le paramètre <code>valeurJour</code> n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.prototype.getUTCDate", "getUTCDate()")}} sera utilisée.</p> +Si le paramètre `valeurJour` n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.prototype.getUTCDate", "getUTCDate()")}} sera utilisée. -<p>Si un paramètre renseigné n'est pas dans l'intervalle attendues, <code>setUTCMonth()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise 15 pour <code>valeurMois</code>, l'année sera incrémentée de 1 (année + 1), et 3 sera utilisé pour le mois.</p> +Si un paramètre renseigné n'est pas dans l'intervalle attendues, `setUTCMonth()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise 15 pour `valeurMois`, l'année sera incrémentée de 1 (année + 1), et 3 sera utilisé pour le mois. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCMonth()">Utiliser <code>setUTCMonth()</code></h3> +### Utiliser `setUTCMonth()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCMonth(11); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.39', 'Date.prototype.setUTCMonth')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutcmonth', 'Date.prototype.setUTCMonth')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcmonth', 'Date.prototype.setUTCMonth')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCMonth")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCMonth()")}}</li> - <li>{{jsxref("Date.prototype.setMonth()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.39', 'Date.prototype.setUTCMonth')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutcmonth', 'Date.prototype.setUTCMonth')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutcmonth', 'Date.prototype.setUTCMonth')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCMonth")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCMonth()")}} +- {{jsxref("Date.prototype.setMonth()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setutcseconds/index.md b/files/fr/web/javascript/reference/global_objects/date/setutcseconds/index.md index 38bbc89cad..ffb683924a 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setutcseconds/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setutcseconds/index.md @@ -10,82 +10,56 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCSeconds original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setUTCSeconds --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>setUTCSeconds()</strong></code> définit les secondes pour la date, selon UTC.</p> +La méthode **`setUTCSeconds()`** définit les secondes pour la date, selon UTC. -<div>{{EmbedInteractiveExample("pages/js/date-setutcseconds.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-setutcseconds.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setUTCSeconds(valeurSecondes[, valeurMs]) </pre> + dateObj.setUTCSeconds(valeurSecondes[, valeurMs]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurSecondes</code></dt> - <dd>Un entier entre 0 et 59.</dd> - <dt><code>valeurMs</code></dt> - <dd>Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes.</dd> -</dl> +- `valeurSecondes` + - : Un entier entre 0 et 59. +- `valeurMs` + - : Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si le paramètre <code>valeurMs</code> n'est pas utilisée, la valeur renvoyée par la méthode {{jsxref("Date.prototype.getUTCMilliseconds", "getUTCMilliseconds()")}} sera utilisée.</p> +Si le paramètre `valeurMs` n'est pas utilisée, la valeur renvoyée par la méthode {{jsxref("Date.prototype.getUTCMilliseconds", "getUTCMilliseconds()")}} sera utilisée. -<p>Si un paramètre renseigné est en dehors de l'intervalle attendu, <code>setUTCSeconds()</code> tentera de mettre à jour la date en conséquence. Par exemple, si on utilise 100 pour <code>valeurSecondes</code>, les minutes de la date seront incrémentées de 1, et 40 sera utilisé pour les secondes.</p> +Si un paramètre renseigné est en dehors de l'intervalle attendu, `setUTCSeconds()` tentera de mettre à jour la date en conséquence. Par exemple, si on utilise 100 pour `valeurSecondes`, les minutes de la date seront incrémentées de 1, et 40 sera utilisé pour les secondes. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setUTCSeconds()">Utiliser <code>setUTCSeconds()</code></h3> +### Utiliser `setUTCSeconds()` -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setUTCSeconds(20); -</pre> - -<h2 id="Spécifications">Spécifications</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-15.9.5.31', 'Date.prototype.setUTCSeconds')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setutcseconds', 'Date.prototype.setUTCSeconds')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcseconds', 'Date.prototype.setUTCSeconds')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setUTCSeconds")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.getUTCSeconds()")}}</li> - <li>{{jsxref("Date.prototype.setSeconds()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. | +| {{SpecName('ES5.1', '#sec-15.9.5.31', 'Date.prototype.setUTCSeconds')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.setutcseconds', 'Date.prototype.setUTCSeconds')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.setutcseconds', 'Date.prototype.setUTCSeconds')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setUTCSeconds")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getUTCSeconds()")}} +- {{jsxref("Date.prototype.setSeconds()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/setyear/index.md b/files/fr/web/javascript/reference/global_objects/date/setyear/index.md index 05e61e6700..34756135d3 100644 --- a/files/fr/web/javascript/reference/global_objects/date/setyear/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/setyear/index.md @@ -11,83 +11,57 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/setYear original_slug: Web/JavaScript/Reference/Objets_globaux/Date/setYear --- -<div>{{JSRef}} {{deprecated_header}}</div> +{{JSRef}} {{deprecated_header}} -<p>La méthode <strong><code>setYear()</code></strong> définit l'année pour pour la date, selon l'heure locale. <code>setYear()</code> ne définissant pas des années complêtes ( « bug de l'an 2000 » ), elle n'est plus utilisée et a été remplacée par la méthode {{jsxref("Date.prototype.setFullYear", "setFullYear")}}.</p> +La méthode **`setYear()`** définit l'année pour pour la date, selon l'heure locale. `setYear()` ne définissant pas des années complêtes ( « bug de l'an 2000 » ), elle n'est plus utilisée et a été remplacée par la méthode {{jsxref("Date.prototype.setFullYear", "setFullYear")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.setYear(valeurAnnée)</pre> + dateObj.setYear(valeurAnnée) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>valeurAnnée</code></dt> - <dd>Un entier.</dd> -</dl> +- `valeurAnnée` + - : Un entier. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -<h2 id="Description">Description</h2> +## Description -<p>Si <code>valeurAnnée</code> est un nombre entre 0 et 99 (inclus), alors l'année de <code>dateObj</code> sera définie à 1900 + <code>valeurAnnée</code>. Sinon, l'année de <code>dateObj</code> sera définie à <code>valeurAnnée</code>.</p> +Si `valeurAnnée` est un nombre entre 0 et 99 (inclus), alors l'année de `dateObj` sera définie à 1900 + `valeurAnnée`. Sinon, l'année de `dateObj` sera définie à `valeurAnnée`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_setYear()">Utiliser <code>setYear()</code></h3> +### Utiliser `setYear()` -<p>Les deux premières instructions définissent l'année 1996. La troisième définit l'année 2000.</p> +Les deux premières instructions définissent l'année 1996. La troisième définit l'année 2000. -<pre class="brush: js">var leGrandJour = new Date(); +```js +var leGrandJour = new Date(); leGrandJour.setYear(96); leGrandJour.setYear(1996); leGrandJour.setYear(2000); -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-B.2.5', 'Date.prototype.setYear')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Définie dans l'annexe informative sur la compatibilité.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.setyear', 'Date.prototype.setYear')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.setyear', 'Date.prototype.setYear')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.setYear")}}</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.setFullYear()")}}</li> - <li>{{jsxref("Date.prototype.setUTCFullYear()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-B.2.5', 'Date.prototype.setYear')}} | {{Spec2('ES5.1')}} | Définie dans l'annexe informative sur la compatibilité. | +| {{SpecName('ES6', '#sec-date.prototype.setyear', 'Date.prototype.setYear')}} | {{Spec2('ES6')}} | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. | +| {{SpecName('ESDraft', '#sec-date.prototype.setyear', 'Date.prototype.setYear')}} | {{Spec2('ESDraft')}} | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.setYear")}} + +## Voir aussi + +- {{jsxref("Date.prototype.getFullYear()")}} +- {{jsxref("Date.prototype.getUTCFullYear()")}} +- {{jsxref("Date.prototype.setFullYear()")}} +- {{jsxref("Date.prototype.setUTCFullYear()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/todatestring/index.md b/files/fr/web/javascript/reference/global_objects/date/todatestring/index.md index 0fa5df67f0..50dbe12d4b 100644 --- a/files/fr/web/javascript/reference/global_objects/date/todatestring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/todatestring/index.md @@ -10,82 +10,57 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toDateString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toDateString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toDateString()</strong></code> renvoie la date contenue dans un objet {{jsxref("Date")}} sous la forme d'une chaîne de caractères lisible par un humain, en anglais américain et au format suivant :</p> +La méthode **`toDateString()`** renvoie la date contenue dans un objet {{jsxref("Date")}} sous la forme d'une chaîne de caractères lisible par un humain, en anglais américain et au format suivant : -<ol> - <li>Les trois premières lettre indiquent le jour</li> - <li>Les trois lettres suivantes indiquent le mois</li> - <li>Les deux chiffres suivants indiquent le jour du mois (et sont complétés avec un 0 devant si besoin)</li> - <li>Les quatre chiffres restants indiquent l'année (si besoin complétées avec des 0 comme préfixe)</li> -</ol> +1. Les trois premières lettre indiquent le jour +2. Les trois lettres suivantes indiquent le mois +3. Les deux chiffres suivants indiquent le jour du mois (et sont complétés avec un 0 devant si besoin) +4. Les quatre chiffres restants indiquent l'année (si besoin complétées avec des 0 comme préfixe) -<div>{{EmbedInteractiveExample("pages/js/date-todatestring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-todatestring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toDateString()</pre> + dateObj.toDateString() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères qui représente la date indiquée, dans un format anglais américain.</p> +Une chaîne de caractères qui représente la date indiquée, dans un format anglais américain. -<h2 id="Description">Description</h2> +## Description -<p>Les instances de {{jsxref("Date")}} représentent un point précis dans le temps. Appeler {{jsxref("Date.prototype.toString", "toString")}} retournera la date formatée sous une forme lisible par un humain, en anglais américain. Pour le moteur JavaScript <a href="/fr/docs/SpiderMonkey">SpiderMonkey</a>, ceci consiste en : la partie « date » (jour, mois et année) suivie de la partie « heure » (heures, minutes, secondes et fuseau horaire). Il est parfois préférable d'obtenir uniquement la partie « date » ; ceci est possible grâce à la méthode <code>toDateString()</code>.</p> +Les instances de {{jsxref("Date")}} représentent un point précis dans le temps. Appeler {{jsxref("Date.prototype.toString", "toString")}} retournera la date formatée sous une forme lisible par un humain, en anglais américain. Pour le moteur JavaScript [SpiderMonkey](/fr/docs/SpiderMonkey), ceci consiste en : la partie « date » (jour, mois et année) suivie de la partie « heure » (heures, minutes, secondes et fuseau horaire). Il est parfois préférable d'obtenir uniquement la partie « date » ; ceci est possible grâce à la méthode `toDateString()`. -<p>La méthode <code>toDateString()</code> est particulièrement utile car, pour les moteurs implémentant fidèlement <a href="/fr/docs/JavaScript/Language_Resources">ECMA-262</a>, il peut y avoir certaines différences dans la chaîne de caractères produite par <code>toString()</code> sur les objets <code>Date</code>. Le format dépend de l'implémentation et les techniques simples de découpage de texte peuvent ne pas produire un résultat cohérent à travers les différents moteurs.</p> +La méthode `toDateString()` est particulièrement utile car, pour les moteurs implémentant fidèlement [ECMA-262](/fr/docs/JavaScript/Language_Resources), il peut y avoir certaines différences dans la chaîne de caractères produite par `toString()` sur les objets `Date`. Le format dépend de l'implémentation et les techniques simples de découpage de texte peuvent ne pas produire un résultat cohérent à travers les différents moteurs. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_simplement_toDateString()">Utiliser simplement <code>toDateString()</code></h3> +### Utiliser simplement `toDateString()` -<pre class="brush:js">var d = new Date(1993, 6, 28, 14, 39, 7); +```js +var d = new Date(1993, 6, 28, 14, 39, 7); console.log(d.toString()); // écrit Wed Jul 28 1993 14:39:07 GMT-0600 (PDT) -console.log(d.toDateString()); // écrit Wed Jul 28 1993</pre> - -<h2 id="Spécifications">Spécifications</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('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.3', 'Date.prototype.toDateString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.todatestring', 'Date.prototype.toDateString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.todatestring', 'Date.prototype.toDateString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toDateString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toString()")}}</li> -</ul> +console.log(d.toDateString()); // écrit Wed Jul 28 1993 +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. | +| {{SpecName('ES5.1', '#sec-15.9.5.3', 'Date.prototype.toDateString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.todatestring', 'Date.prototype.toDateString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.todatestring', 'Date.prototype.toDateString')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toDateString")}} + +## Voir aussi + +- {{jsxref("Date.prototype.toLocaleDateString()")}} +- {{jsxref("Date.prototype.toTimeString()")}} +- {{jsxref("Date.prototype.toString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/togmtstring/index.md b/files/fr/web/javascript/reference/global_objects/date/togmtstring/index.md index 701cc5c49a..6cabfdde5a 100644 --- a/files/fr/web/javascript/reference/global_objects/date/togmtstring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/togmtstring/index.md @@ -11,74 +11,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toGMTString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toGMTString --- -<div>{{JSRef}} {{deprecated_header}}</div> +{{JSRef}} {{deprecated_header}} -<p>La méthode <code><strong>toGMTString()</strong></code> convertit une date en une chaîne de caractères, en utilisant les conventions Internet pour GMT. Le format exact de la valeur renvoyée par <code>toGMTString()</code> varie en fonction de la plateforme et du navigateur web. En général, le texte produit est formaté pour être lisible par un humain.</p> +La méthode **`toGMTString()`** convertit une date en une chaîne de caractères, en utilisant les conventions Internet pour GMT. Le format exact de la valeur renvoyée par `toGMTString()` varie en fonction de la plateforme et du navigateur web. En général, le texte produit est formaté pour être lisible par un humain. -<div class="note"> -<p><strong>Note :</strong> <code>toGMTString()</code> est obsolète et ne doit plus être utilisé. Il existe encore uniquementpour des questions de compatibilité. La méthode {{jsxref("Date.prototype.toUTCString", "toUTCString()")}} doit être utilisée à la place.</p> -</div> +> **Note :** `toGMTString()` est obsolète et ne doit plus être utilisé. Il existe encore uniquementpour des questions de compatibilité. La méthode {{jsxref("Date.prototype.toUTCString", "toUTCString()")}} doit être utilisée à la place. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toGMTString()</pre> + dateObj.toGMTString() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant la date indiquée selon la convention internet pour GMT (<em>Greenwich Mean Time</em>).</p> +Une chaîne de caractères représentant la date indiquée selon la convention internet pour GMT (_Greenwich Mean Time_). -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_toGMTString()">Utiliser <code>toGMTString()</code></h3> +### Utiliser `toGMTString()` -<p>Dans cet exemple, la méthode <code>toGMTString()</code> convertit la date vers GMT (UTC) en utilisant la différence avec le fuseau horaire du système d'exploitation. Elle renvoie une chaîne de caractères similaire à celle de l'exemple. La forme exacte de cette chaîne de caractères dépend de la plateforme.</p> +Dans cet exemple, la méthode `toGMTString()` convertit la date vers GMT (UTC) en utilisant la différence avec le fuseau horaire du système d'exploitation. Elle renvoie une chaîne de caractères similaire à celle de l'exemple. La forme exacte de cette chaîne de caractères dépend de la plateforme. -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var str = aujourdhui.toGMTString(); // Obsolète ! Utilisez toUTCString() console.log(str); // Mon, 18 Dec 1995 17:28:35 GMT -</pre> - -<h2 id="Spécifications">Spécifications</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 et déjà déclarée comme dépréciée. Implémentée avec JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-B.2.6', 'Date.prototype.toGMTString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Définie dans l'annexe informative sur la compatibilité.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.togmtstring', 'Date.prototype.toGMTString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.togmtstring', 'Date.prototype.toGMTString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toGMTString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toUTCString()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale et déjà déclarée comme dépréciée. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-B.2.6', 'Date.prototype.toGMTString')}} | {{Spec2('ES5.1')}} | Définie dans l'annexe informative sur la compatibilité. | +| {{SpecName('ES6', '#sec-date.prototype.togmtstring', 'Date.prototype.toGMTString')}} | {{Spec2('ES6')}} | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. | +| {{SpecName('ESDraft', '#sec-date.prototype.togmtstring', 'Date.prototype.toGMTString')}} | {{Spec2('ESDraft')}} | Définie dans l'annexe normative sur les fonctionnalités additionnelles des navigateurs web. | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toGMTString")}} + +## Voir aussi + +- {{jsxref("Date.prototype.toLocaleDateString()")}} +- {{jsxref("Date.prototype.toTimeString()")}} +- {{jsxref("Date.prototype.toUTCString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/toisostring/index.md b/files/fr/web/javascript/reference/global_objects/date/toisostring/index.md index 102c8dfb19..04e1ce306e 100644 --- a/files/fr/web/javascript/reference/global_objects/date/toisostring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/toisostring/index.md @@ -11,40 +11,42 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toISOString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toISOString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toISOString()</strong></code> renvoie une chaîne de caractères au format ISO (<a href="http://en.wikipedia.org/wiki/ISO_8601">ISO 8601 Extended Format</a>), qui peut être décrite de cette façon : <code><strong>YYYY-MM-DDTHH:mm:ss.sssZ</strong></code> (toujours longue de 24 caractères) ou de cette façon <strong><code>±YYYYYY-MM-DDTHH:mm:ss.sssZ</code></strong> (27 caractères). Le fuseau horaire est toujours UTC, comme l'indique le suffixe « Z » (pour zéro décalage avec UTC).</p> +La méthode **`toISOString()`** renvoie une chaîne de caractères au format ISO ([ISO 8601 Extended Format](http://en.wikipedia.org/wiki/ISO_8601)), qui peut être décrite de cette façon : **`YYYY-MM-DDTHH:mm:ss.sssZ`** (toujours longue de 24 caractères) ou de cette façon **`±YYYYYY-MM-DDTHH:mm:ss.sssZ`** (27 caractères). Le fuseau horaire est toujours UTC, comme l'indique le suffixe « Z » (pour zéro décalage avec UTC). -<div>{{EmbedInteractiveExample("pages/js/date-toisostring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-toisostring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toISOString()</pre> + dateObj.toISOString() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant la date indiquée au format <a href="https://fr.wikipedia.org/wiki/ISO_8601">ISO 8601</a> selon le temps universel.</p> +Une chaîne de caractères représentant la date indiquée au format [ISO 8601](https://fr.wikipedia.org/wiki/ISO_8601) selon le temps universel. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_toISOString()">Utiliser <code>toISOString()</code></h3> +### Utiliser `toISOString()` -<pre class="brush: js">var aujourdhui = new Date("05 October 2011 14:48 UTC"); +```js +var aujourdhui = new Date("05 October 2011 14:48 UTC"); console.log(aujourdhui.toISOString()); // Renvoie "2011-10-05T14:48:00.000Z" -</pre> +``` -<p>L'exemple ci-dessus analyse une chaîne de caractères non-standard, qui peut donc être incorrectement intérprété par des navigateurs n'utilisant pas Gecko.</p> +L'exemple ci-dessus analyse une chaîne de caractères non-standard, qui peut donc être incorrectement intérprété par des navigateurs n'utilisant pas Gecko. -<h2 id="Prothèse_d'émulation_(polyfill)">Prothèse d'émulation (<em>polyfill</em>)</h2> +## Prothèse d'émulation (_polyfill_) -<p>Cette méthode fut standardisée avec la cinquième édition d'ECMAScript. Afin d'utiliser cette méthode avec les moteurs qui n'en disposent pas nativement, on pourra utiliser ce fragment de code :</p> +Cette méthode fut standardisée avec la cinquième édition d'ECMAScript. Afin d'utiliser cette méthode avec les moteurs qui n'en disposent pas nativement, on pourra utiliser ce fragment de code : -<pre class="brush:js">if ( !Date.prototype.toISOString ) { +```js +if ( !Date.prototype.toISOString ) { ( function() { function pad(number) { - if ( number < 10 ) { + if ( number < 10 ) { return '0' + number; } return number; @@ -62,43 +64,23 @@ console.log(aujourdhui.toISOString()); // Renvoie "2011-10-05T14:48:00.000Z" }; }() ); -}</pre> - -<h2 id="Spécifications">Spécifications</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('ES5.1', '#sec-15.9.5.43', 'Date.prototype.toISOString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.8.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toISOString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toUTCString()")}}</li> -</ul> +} +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES5.1', '#sec-15.9.5.43', 'Date.prototype.toISOString')}} | {{Spec2('ES5.1')}} | Définition initiale. Implémentée avec JavaScript 1.8. | +| {{SpecName('ES6', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toISOString")}} + +## Voir aussi + +- {{jsxref("Date.prototype.toLocaleDateString()")}} +- {{jsxref("Date.prototype.toTimeString()")}} +- {{jsxref("Date.prototype.toUTCString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/tojson/index.md b/files/fr/web/javascript/reference/global_objects/date/tojson/index.md index c05c5d8d13..7909061c35 100644 --- a/files/fr/web/javascript/reference/global_objects/date/tojson/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/tojson/index.md @@ -10,69 +10,49 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toJSON original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toJSON --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toJSON()</strong></code> renvoie une chaîne représentant l'objet {{jsxref("Date")}} sous forme {{Glossary("JSON")}}</p> +La méthode **`toJSON()`** renvoie une chaîne représentant l'objet {{jsxref("Date")}} sous forme {{Glossary("JSON")}} -<div>{{EmbedInteractiveExample("pages/js/date-tojson.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-tojson.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toJSON()</pre> + dateObj.toJSON() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant la date indiquée.</p> +Une chaîne de caractères représentant la date indiquée. -<h2 id="Description">Description</h2> +## Description -<p>Les instances de {{jsxref("Date")}} identifient un instant précis dans le temps. Appeler <code>toJSON()</code> renvoie une chaîne de caractères formatée en JSON (en utilisant {{jsxref("Date.prototype.toISOString", "toISOString()")}}), représentant la valeur de l'objet <code>Date</code>. Cette méthode est généralement utilisée, par défaut, pour sérialiser les objets <code>Date</code> lors d'une sérialisation au format JSON.</p> +Les instances de {{jsxref("Date")}} identifient un instant précis dans le temps. Appeler `toJSON()` renvoie une chaîne de caractères formatée en JSON (en utilisant {{jsxref("Date.prototype.toISOString", "toISOString()")}}), représentant la valeur de l'objet `Date`. Cette méthode est généralement utilisée, par défaut, pour sérialiser les objets `Date` lors d'une sérialisation au format JSON. -<h2 id="Exemple">Exemple</h2> +## Exemple -<h3 id="Utiliser_toJSON()">Utiliser <code>toJSON()</code></h3> +### Utiliser `toJSON()` -<pre class="brush:js">var jsonDate = (new Date()).toJSON(); +```js +var jsonDate = (new Date()).toJSON(); var retourVersDate = new Date(jsonDate); console.log(jsonDate); //2015-10-26T07:46:36.611Z -</pre> - -<h2 id="Spécifications">Spécifications</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('ES5.1', '#sec-15.9.5.44', 'Date.prototype.toJSON')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.8.5.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.tojson', 'Date.prototype.toJSON')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.tojson', 'Date.prototype.toJSON')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toJSON")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toUTCString()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------------------------------------------- | +| {{SpecName('ES5.1', '#sec-15.9.5.44', 'Date.prototype.toJSON')}} | {{Spec2('ES5.1')}} | Définition initiale. Implémentée avec JavaScript 1.8.5. | +| {{SpecName('ES6', '#sec-date.prototype.tojson', 'Date.prototype.toJSON')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.tojson', 'Date.prototype.toJSON')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toJSON")}} + +## Voir aussi + +- {{jsxref("Date.prototype.toLocaleDateString()")}} +- {{jsxref("Date.prototype.toTimeString()")}} +- {{jsxref("Date.prototype.toUTCString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/tolocaledatestring/index.md b/files/fr/web/javascript/reference/global_objects/date/tolocaledatestring/index.md index e773e49be3..3d0c471682 100644 --- a/files/fr/web/javascript/reference/global_objects/date/tolocaledatestring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/tolocaledatestring/index.md @@ -12,47 +12,50 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toLocaleDateString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toLocaleDateString()</strong></code> renvoie une chaine de caractères correspondant à la date (le fragment de l'objet qui correspond à la date : jour, mois, année) exprimée selon une locale. Les arguments <code>locales</code> et <code>options</code> permettent aux applications de définir le langage utilisé pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation.</p> +La méthode **`toLocaleDateString()`** renvoie une chaine de caractères correspondant à la date (le fragment de l'objet qui correspond à la date : jour, mois, année) exprimée selon une locale. Les arguments `locales` et `options` permettent aux applications de définir le langage utilisé pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation. -<div>{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toLocaleDateString([locales [, options]])</pre> + dateObj.toLocaleDateString([locales [, options]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Voir le tableau de <a href="#compat">compatibilité des navigateurs</a> afin de déterminer quels navigateurs respectent les arguments <code>locales</code> et <code>options</code> ainsi que l'exemple <a href="#check">Vérifier le support des arguments locales et options</a> qui permet de détecter cette fonctionnalité.</p> +Voir le tableau de [compatibilité des navigateurs](#compat) afin de déterminer quels navigateurs respectent les arguments `locales` et `options` ainsi que l'exemple [Vérifier le support des arguments locales et options](#check) qui permet de détecter cette fonctionnalité. -<p>{{page('fr/docs/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}}</p> +{{page('fr/docs/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}} -<p>La valeur par défaut de chacun des composants de la date vaut {{jsxref("undefined")}}, si les propriétés <code>weekday</code>, <code>year</code>, <code>month</code>, <code>day</code> sont toutes <code>undefined</code>, on suppose alors que <code>year</code>, <code>month</code>, et <code>day</code> sont « numériques ».</p> +La valeur par défaut de chacun des composants de la date vaut {{jsxref("undefined")}}, si les propriétés `weekday`, `year`, `month`, `day` sont toutes `undefined`, on suppose alors que `year`, `month`, et `day` sont « numériques ». -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères qui représente le jour de la date indiquée selon des options de locales.</p> +Une chaîne de caractères qui représente le jour de la date indiquée selon des options de locales. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_toLocaleDateString()">Utiliser <code>toLocaleDateString()</code></h3> +### Utiliser `toLocaleDateString()` -<p>Voici un usage simple qui ne définit pas de locale : une chaine de caractères dans une locale et avec des options par défaut est renvoyée.</p> +Voici un usage simple qui ne définit pas de locale : une chaine de caractères dans une locale et avec des options par défaut est renvoyée. -<pre class="brush:js">var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); // toLocaleDateString() sans argument, on utilise donc // les valeurs par défaut (de l'implémentation) // pour la locale, et le fuseau horaire date.toLocaleDateString(); -// → "12/12/2012" si exécuté dans une locale fr et le fuseau horaire CEST</pre> +// → "12/12/2012" si exécuté dans une locale fr et le fuseau horaire CEST +``` -<h3 id="Vérifier_le_support_des_arguments_locales_et_options">Vérifier le support des arguments <code>locales</code> et <code>options</code></h3> +### Vérifier le support des arguments `locales` et `options` -<p>Les arguments <code>locales</code> et <code>options</code> ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception<code> RangeError</code> :</p> +Les arguments `locales` et `options` ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception` RangeError` : -<pre class="brush: js">function toLocaleDateStringSupportsLocales() { +```js +function toLocaleDateStringSupportsLocales() { try { new Date().toLocaleDateString("i"); } catch (e) { @@ -60,13 +63,14 @@ date.toLocaleDateString(); } return false; } -</pre> +``` -<h3 id="Utiliser_l'argument_locales">Utiliser l'argument <code>locales</code></h3> +### Utiliser l'argument `locales` -<p>Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument <code>locales</code> :</p> +Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument `locales` : -<pre class="brush: js">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // les formats qui suivent se basent sur le // fuseau horaire CEST @@ -85,7 +89,7 @@ alert(date.toLocaleDateString("ko-KR")); // l'arabe, dans la plupart des pays arabophones, utilise les chiffres arabes alert(date.toLocaleDateString("ar-EG")); -// → "<span dir="rtl">٢٠/١٢/٢٠١٢</span>" +// → "٢٠/١٢/٢٠١٢" // en ce qui concerne le japonais, les applications peuvent // souhaiter utiliser le calendrier japonais @@ -97,13 +101,14 @@ alert(date.toLocaleDateString("ja-JP-u-ca-japanese")); // il est possible de fournir un langage de recours (ici l'indonésien) alert(date.toLocaleDateString(["ban", "id"])); // → "20/12/2012" -</pre> +``` -<h3 id="Utiliser_l'argument_options">Utiliser l'argument <code>options</code></h3> +### Utiliser l'argument `options` -<p>Les résultats fournis par <code>toLocaleDateString()</code> peuvent être personnalisés grâce à l'argument <code>options</code> :</p> +Les résultats fournis par `toLocaleDateString()` peuvent être personnalisés grâce à l'argument `options` : -<pre class="brush: js">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // fournir le jour de la semaine avec une date longe var options = {weekday: "long", year: "numeric", month: "long", day: "numeric"}; @@ -116,68 +121,31 @@ options.timeZone = "UTC"; options.timeZoneName = "short"; alert(date.toLocaleDateString("en-US", options)); // → "Thursday, December 20, 2012, GMT" -</pre> - -<h2 id="Performance">Performance</h2> - -<p>Lorsque des grands nombres ou de grandes dates sont formatés, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie par sa propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}.</p> - -<h2 id="Spécifications">Spécifications</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('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', 'sec-15.9.5.6', 'Date.prototype.toLocaleDateString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.tolocaledatestring', 'Date.prototype.toLocaleDateString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.tolocaledatestring', 'Date.prototype.toLocaleDateString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES Int 1.0', '#sec-13.3.2', 'Date.prototype.toLocaleDateString')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Définition des arguments <code>locales</code> et <code>options</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES Int 2.0', '#sec-13.3.2', 'Date.prototype.toLocaleDateString')}}</td> - <td>{{Spec2('ES Int 2.0')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleDateString', 'Date.prototype.toLocaleDateString')}}</td> - <td>{{Spec2('ES Int Draft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toLocaleDateString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}</li> - <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> - <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toString()")}}</li> -</ul> +``` + +## Performance + +Lorsque des grands nombres ou de grandes dates sont formatés, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie par sa propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}. + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------------------------------------- | +| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', 'sec-15.9.5.6', 'Date.prototype.toLocaleDateString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.tolocaledatestring', 'Date.prototype.toLocaleDateString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.tolocaledatestring', 'Date.prototype.toLocaleDateString')}} | {{Spec2('ESDraft')}} | | +| {{SpecName('ES Int 1.0', '#sec-13.3.2', 'Date.prototype.toLocaleDateString')}} | {{Spec2('ES Int 1.0')}} | Définition des arguments `locales` et `options`. | +| {{SpecName('ES Int 2.0', '#sec-13.3.2', 'Date.prototype.toLocaleDateString')}} | {{Spec2('ES Int 2.0')}} | | +| {{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleDateString', 'Date.prototype.toLocaleDateString')}} | {{Spec2('ES Int Draft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toLocaleDateString")}} + +## Voir aussi + +- {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} +- {{jsxref("Date.prototype.toLocaleString()")}} +- {{jsxref("Date.prototype.toLocaleTimeString()")}} +- {{jsxref("Date.prototype.toString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/tolocalestring/index.md b/files/fr/web/javascript/reference/global_objects/date/tolocalestring/index.md index 8eebb47913..22c2f30587 100644 --- a/files/fr/web/javascript/reference/global_objects/date/tolocalestring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/tolocalestring/index.md @@ -12,47 +12,50 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toLocaleString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toLocaleString()</strong></code> renvoie une chaine de caractères représentant la date selon une locale. Les arguments <code>locales</code> et <code>options</code> permettent aux applications de définir le langage à utiliser pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation.</p> +La méthode **`toLocaleString()`** renvoie une chaine de caractères représentant la date selon une locale. Les arguments `locales` et `options` permettent aux applications de définir le langage à utiliser pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation. -<div>{{EmbedInteractiveExample("pages/js/date-tolocalestring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-tolocalestring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj.toLocaleString([locales [, options]])</var></pre> + dateObj.toLocaleString([locales [, options]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Voir le tableau de <a href="#compat" title="#Compatibilit.C3.A9_des_navigateurs">compatibilité des navigateurs</a> afin de déterminer quels navigateurs respectent les arguments <code>locales</code> et <code>options</code> ainsi que l'exemple <a href="#check">Vérifier le support des arguments <code>locales</code> et <code>options</code></a> qui permet de détecter cette fonctionnalité.</p> +Voir le tableau de [compatibilité des navigateurs](#compat "#Compatibilit.C3.A9_des_navigateurs") afin de déterminer quels navigateurs respectent les arguments `locales` et `options` ainsi que l'exemple [Vérifier le support des arguments `locales` et `options`](#check) qui permet de détecter cette fonctionnalité. -<p>{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}}</p> +{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}} -<p>La valeur par défaut de chacun des composants de la date-heure vaut {{jsxref("undefined")}}, mais si les propriétés <code>weekday</code>, <code>year</code>, <code>month</code>, <code>day</code>, <code>hour</code>, <code>minute</code>, <code>second</code> sont toutes {{jsxref("undefined")}}, alors <code>weekday</code>, <code>year</code>, <code>month</code>, <code>day</code>, <code>hour</code>, <code>minute</code> et <code>second</code> sont supposés être "numeric".</p> +La valeur par défaut de chacun des composants de la date-heure vaut {{jsxref("undefined")}}, mais si les propriétés `weekday`, `year`, `month`, `day`, `hour`, `minute`, `second` sont toutes {{jsxref("undefined")}}, alors `weekday`, `year`, `month`, `day`, `hour`, `minute` et `second` sont supposés être "numeric". -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant la date indiquée selon des conventions de locales spécifiques.</p> +Une chaîne de caractères représentant la date indiquée selon des conventions de locales spécifiques. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_toLocaleString()">Utiliser <code>toLocaleString()</code></h3> +### Utiliser `toLocaleString()` -<p>Voici un usage simple qui ne définit pas de locale : une chaine de caractères dans une locale et avec des options par défaut est renvoyée.</p> +Voici un usage simple qui ne définit pas de locale : une chaine de caractères dans une locale et avec des options par défaut est renvoyée. -<pre class="brush:js">var date = new Date(Date.UTC(2014, 11, 21, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2014, 11, 21, 3, 0, 0)); // toLocaleString() sans argument, on utilise donc // les valeurs par défaut (de l'implémentation) // pour la locale, et le fuseau horaire date.toLocaleString(); -// → "21/12/2014 04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST</pre> +// → "21/12/2014 04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST +``` -<h3 id="Vérifier_le_support_des_arguments_locales_et_options">Vérifier le support des arguments <code>locales</code> et <code>options</code></h3> +### Vérifier le support des arguments `locales` et `options` -<p>Les arguments <code>locales</code> et <code>options</code> ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception {{jsxref("RangeError")}} :</p> +Les arguments `locales` et `options` ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception {{jsxref("RangeError")}} : -<pre class="brush: js">function toLocaleStringSupportsLocales() { +```js +function toLocaleStringSupportsLocales() { try { new Date().toLocaleString("i"); } catch (e) { @@ -60,13 +63,14 @@ date.toLocaleString(); } return false; } -</pre> +``` -<h3 id="Utiliser_locales">Utiliser <code>locales</code></h3> +### Utiliser `locales` -<p>Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument <code>locales</code> :</p> +Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument `locales` : -<pre class="brush: js">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // les formats qui suivent se basent sur le // fuseau horaire CEST @@ -97,13 +101,14 @@ console.log(date.toLocaleString("ja-JP-u-ca-japanese")); // il est possible de fournir un langage de recours (ici l'indonésien) console.log(date.toLocaleString(["ban", "id"])); // → "20/12/2012 04.00.00" -</pre> +``` -<h3 id="Utiliser_options">Utiliser <code>options</code></h3> +### Utiliser `options` -<p>Les résultats fournis par <code>toLocaleString()</code> peuvent être personnalisés grâce à l'argument <code>options</code> :</p> +Les résultats fournis par `toLocaleString()` peuvent être personnalisés grâce à l'argument `options` : -<pre class="brush: js">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // obtenir le jour de la semaine avec une date longue var options = {weekday: "long", year: "numeric", month: "long", day: "numeric"}; @@ -119,83 +124,45 @@ console.log(date.toLocaleString("en-US", options)); // parfois, même les USA ont besoin d'avoir une heure sur 24h console.log(date.toLocaleString("en-US", {hour12: false})); // → "12/19/2012, 19:00:00" -</pre> +``` -<h3 id="Comparaison_des_dates_formatées_et_des_valeurs_statiques">Comparaison des dates formatées et des valeurs statiques</h3> +### Comparaison des dates formatées et des valeurs statiques -<p>La plupart du temps, le format renvoyé par <code>toLocaleString()</code> est cohérent. Toutefois, cela peut évoluer à l'avenir et n'est pas garanti pour l'ensemble des langues (de telles variations sont souhaitables et permises par la spécification). Ainsi, IE et Edge ajoutent des caractères de contrôle bidirectionnels autour des dates afin que le texte produit ait une directionalité cohérente avec le texte avec lequel elles seront concaténées.</p> +La plupart du temps, le format renvoyé par `toLocaleString()` est cohérent. Toutefois, cela peut évoluer à l'avenir et n'est pas garanti pour l'ensemble des langues (de telles variations sont souhaitables et permises par la spécification). Ainsi, IE et Edge ajoutent des caractères de contrôle bidirectionnels autour des dates afin que le texte produit ait une directionalité cohérente avec le texte avec lequel elles seront concaténées. -<p>Aussi, mieux vaut ne pas comparer un résultat fourni par <code>format()</code> avec une valeur statique :</p> +Aussi, mieux vaut ne pas comparer un résultat fourni par `format()` avec une valeur statique : -<pre class="brush: js; example-bad">"1.1.2019, 01:00:00" === new Date("2019-01-01T00:00:00.000000Z").toLocaleString(); +```js example-bad +"1.1.2019, 01:00:00" === new Date("2019-01-01T00:00:00.000000Z").toLocaleString(); // true pour Firefox et les autres // false pour IE et Edge -</pre> - -<div class="blockIndicator note"> -<p><strong>Note :</strong> Voir aussi ce fil <a href="https://stackoverflow.com/questions/25574963/ies-tolocalestring-has-strange-characters-in-results">StackOverflow</a> pour plus de détails et d'exemples.</p> -</div> - -<h2 id="Performance">Performance</h2> - -<p>Quand vous formatez d'importants volumes de dates, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie via la propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}.</p> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.5', 'Date.prototype.toLocaleString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES Int 1.0', '#sec-13.3.1', 'Date.prototype.toLocaleString')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Définition des arguments <code>locales</code> et <code>options</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES Int 2.0', '#sec-13.3.1', 'Date.prototype.toLocaleString')}}</td> - <td>{{Spec2('ES Int 2.0')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleString', 'Date.prototype.toLocaleString')}}</td> - <td>{{Spec2('ES Int Draft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toLocaleString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}</li> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toString()")}}</li> -</ul> +``` + +> **Note :** Voir aussi ce fil [StackOverflow](https://stackoverflow.com/questions/25574963/ies-tolocalestring-has-strange-characters-in-results) pour plus de détails et d'exemples. + +## Performance + +Quand vous formatez d'importants volumes de dates, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie via la propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}. + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.5', 'Date.prototype.toLocaleString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleString')}} | {{Spec2('ESDraft')}} | | +| {{SpecName('ES Int 1.0', '#sec-13.3.1', 'Date.prototype.toLocaleString')}} | {{Spec2('ES Int 1.0')}} | Définition des arguments `locales` et `options`. | +| {{SpecName('ES Int 2.0', '#sec-13.3.1', 'Date.prototype.toLocaleString')}} | {{Spec2('ES Int 2.0')}} | | +| {{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleString', 'Date.prototype.toLocaleString')}} | {{Spec2('ES Int Draft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toLocaleString")}} + +## Voir aussi + +- {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} +- {{jsxref("Date.prototype.toLocaleDateString()")}} +- {{jsxref("Date.prototype.toLocaleTimeString()")}} +- {{jsxref("Date.prototype.toString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md b/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md index 28764c098c..b6e4af66c9 100644 --- a/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md @@ -12,47 +12,50 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleTimeString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toLocaleTimeString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toLocaleTimeString()</strong></code> renvoie une chaine de caractères correspondant à l'heure dans la date, exprimée selon une locale. Les arguments <code>locales</code> et <code>options</code> permettent aux applications de définir le langage utilisé pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation.</p> +La méthode **`toLocaleTimeString()`** renvoie une chaine de caractères correspondant à l'heure dans la date, exprimée selon une locale. Les arguments `locales` et `options` permettent aux applications de définir le langage utilisé pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation. -<div>{{EmbedInteractiveExample("pages/js/date-tolocaletimestring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-tolocaletimestring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toLocaleTimeString([locales [, options]])</pre> + dateObj.toLocaleTimeString([locales [, options]]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Voir le tableau de <a href="#compat" title="#Compatibilit.C3.A9_des_navigateurs">compatibilité des navigateurs</a> afin de déterminer quels navigateurs respectent les arguments <code>locales</code> et <code>options</code> ainsi que l'exemple <a href="#check">Vérifier le support des arguments <code>locales</code> et <code>options</code></a> qui permet de détecter cette fonctionnalité.</p> +Voir le tableau de [compatibilité des navigateurs](#compat "#Compatibilit.C3.A9_des_navigateurs") afin de déterminer quels navigateurs respectent les arguments `locales` et `options` ainsi que l'exemple [Vérifier le support des arguments `locales` et `options`](#check) qui permet de détecter cette fonctionnalité. -<p>{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Param.C3.A8tres')}}</p> +{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Param.C3.A8tres')}} -<p>La valeur par défaut de chacun des composants de la date vaut {{jsxref("undefined")}}, si les propriétés <code>hour</code>, <code>minute</code>, <code>second</code> sont toutes <code>undefined</code>, on suppose alors que <code>hour</code>, <code>minute</code>, et <code>second</code> sont "numeric".</p> +La valeur par défaut de chacun des composants de la date vaut {{jsxref("undefined")}}, si les propriétés `hour`, `minute`, `second` sont toutes `undefined`, on suppose alors que `hour`, `minute`, et `second` sont "numeric". -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères qui représente l'heure de la date indiquée selon des conventions de locales spécifiques.</p> +Une chaîne de caractères qui représente l'heure de la date indiquée selon des conventions de locales spécifiques. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_toLocaleTimeString()">Utiliser <code>toLocaleTimeString()</code></h3> +### Utiliser `toLocaleTimeString()` -<p>Voici un usage simple qui ne définit pas de locale : une chaine de caractères dans une locale et avec des options par défaut est renvoyée.</p> +Voici un usage simple qui ne définit pas de locale : une chaine de caractères dans une locale et avec des options par défaut est renvoyée. -<pre class="brush:js">var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); // toLocaleTimeString() sans argument, on utilise donc // les valeurs par défaut (de l'implémentation) // pour la locale, et le fuseau horaire console.log(date.toLocaleTimeString()); -// → "04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST</pre> +// → "04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST +``` -<h3 id="Vérifier_le_support_des_arguments_locales_et_options">Vérifier le support des arguments <code>locales</code> et <code>options</code></h3> +### Vérifier le support des arguments `locales` et `options` -<p>Les arguments <code>locales</code> et <code>options</code> ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception<code> RangeError</code> :</p> +Les arguments `locales` et `options` ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception` RangeError` : -<pre class="brush: js">function toLocaleTimeStringSupportsLocales() { +```js +function toLocaleTimeStringSupportsLocales() { try { new Date().toLocaleTimeString("i"); } catch (e) { @@ -60,13 +63,14 @@ console.log(date.toLocaleTimeString()); } return false; } -</pre> +``` -<h3 id="Utiliser_locales">Utiliser <code>locales</code></h3> +### Utiliser `locales` -<p>Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument <code>locales</code> :</p> +Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument `locales` : -<pre class="brush: js">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // les formats qui suivent se basent sur le // fuseau horaire CEST @@ -91,13 +95,14 @@ console.log(date.toLocaleTimeString("ar-EG")); // il est possible de fournir un langage de recours (ici l'indonésien) console.log(date.toLocaleTimeString(["ban", "id"])); // → "4.00.00" -</pre> +``` -<h3 id="Utiliser_options">Utiliser <code>options</code></h3> +### Utiliser `options` -<p>Les résultats fournis par <code>toLocaleTimeString()</code> peuvent être personnalisés grâce à l'argument <code>options</code> :</p> +Les résultats fournis par `toLocaleTimeString()` peuvent être personnalisés grâce à l'argument `options` : -<pre class="brush: js">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); // une application peut vouloir utiliser UTC et le montrer var options = {timeZone: "UTC", timeZoneName: "short"}; @@ -107,69 +112,32 @@ console.log(date.toLocaleTimeString("en-US", options)); // parfois, même les USA ont besoin du format sur 24h console.log(date.toLocaleTimeString("en-US", {hour12: false})); // → "19:00:00" -</pre> - -<h2 id="Performance">Performance</h2> - -<p>Pour formater de nombreuses dates, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie par sa propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}.</p> - -<h2 id="Spécifications">Spécifications</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('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.7', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES Int 1.0', '#sec-13.3.3', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Définition des arguments <code>locales</code> et <code>options</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES Int 2.0', '#sec-13.3.3', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ES Int 2.0')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleTimeString', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ES Int Draft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toLocaleTimeString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}</li> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> - <li>{{jsxref("Date.prototype.toTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toString()")}}</li> -</ul> +``` + +## Performance + +Pour formater de nombreuses dates, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie par sa propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}. + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------------------------------------- | +| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.7', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ESDraft')}} | | +| {{SpecName('ES Int 1.0', '#sec-13.3.3', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES Int 1.0')}} | Définition des arguments `locales` et `options`. | +| {{SpecName('ES Int 2.0', '#sec-13.3.3', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES Int 2.0')}} | | +| {{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleTimeString', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES Int Draft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toLocaleTimeString")}} + +## Voir aussi + +- {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} +- {{jsxref("Date.prototype.toLocaleDateString()")}} +- {{jsxref("Date.prototype.toLocaleString()")}} +- {{jsxref("Date.prototype.toTimeString()")}} +- {{jsxref("Date.prototype.toString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/tosource/index.md b/files/fr/web/javascript/reference/global_objects/date/tosource/index.md index 93d004781e..0564beedc8 100644 --- a/files/fr/web/javascript/reference/global_objects/date/tosource/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/tosource/index.md @@ -10,47 +10,43 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toSource original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toSource --- -<div>{{JSRef}} {{Non-standard_header}}</div> +{{JSRef}} {{Non-standard_header}} -<p>La méthode <code><strong>toSource()</strong></code> renvoie une chaîne de caractères représentant le code source de l'objet.</p> +La méthode **`toSource()`** renvoie une chaîne de caractères représentant le code source de l'objet. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toSource() -Date.toSource()</pre> + dateObj.toSource() + Date.toSource() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant le code source de l'objet date indiqué.</p> +Une chaîne de caractères représentant le code source de l'objet date indiqué. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>toSource()</code> renvoie les valeur suivantes :</p> +La méthode `toSource()` renvoie les valeur suivantes : -<ul> - <li>Pour l'objet natif {{jsxref("Date")}}, <code>toSource()</code> renvoie la chaîne de caractères suivante, indiquant que le code source n'est pas disponible :</li> -</ul> +- Pour l'objet natif {{jsxref("Date")}}, `toSource()` renvoie la chaîne de caractères suivante, indiquant que le code source n'est pas disponible : -<pre class="brush: js">function Date() { +```js +function Date() { [native code] -}</pre> +} +``` -<ul> - <li>Pour les instances de {{jsxref("Date")}}, <code>toSource()</code> renvoie une chaîne de caractères représentant le code source.</li> -</ul> +- Pour les instances de {{jsxref("Date")}}, `toSource()` renvoie une chaîne de caractères représentant le code source. -<p>Cette méthode est habituellement appelée en interne par le moteur JavaScript et non explicitement dans le code d'un script.</p> +Cette méthode est habituellement appelée en interne par le moteur JavaScript et non explicitement dans le code d'un script. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<p>Ne fait partie d'aucune spécification. Implémentée dans JavaScript 1.3.</p> +Ne fait partie d'aucune spécification. Implémentée dans JavaScript 1.3. -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.Date.toSource")}}</p> +{{Compat("javascript.builtins.Date.toSource")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("Object.prototype.toSource()")}}</li> -</ul> +- {{jsxref("Object.prototype.toSource()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/tostring/index.md b/files/fr/web/javascript/reference/global_objects/date/tostring/index.md index b548fb5d0c..f25b125d01 100644 --- a/files/fr/web/javascript/reference/global_objects/date/tostring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/tostring/index.md @@ -10,123 +10,90 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toString()</strong></code> renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}}.</p> +La méthode **`toString()`** renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}}. -<div>{{EmbedInteractiveExample("pages/js/date-tostring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-tostring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toString()</pre> + dateObj.toString() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant la date indiquée.</p> +Une chaîne de caractères représentant la date indiquée. -<h2 id="Description">Description</h2> +## Description -<p>L'objet {{jsxref("Date")}} remplace la méthode <code>toString()</code> de l'objet {{jsxref("Object")}} ; il n'hérite pas de {{jsxref("Object.prototype.toString()")}}. Pour les objets {{jsxref("Date")}}, la méthode <code>toString()</code> renvoie une représentation textuelle de l'objet.</p> +L'objet {{jsxref("Date")}} remplace la méthode `toString()` de l'objet {{jsxref("Object")}} ; il n'hérite pas de {{jsxref("Object.prototype.toString()")}}. Pour les objets {{jsxref("Date")}}, la méthode `toString()` renvoie une représentation textuelle de l'objet. -<p>La méthode <code>toString()</code> renvoie toujours une chaîne de caractères représentant une date en anglais américain. Ce format a été standardisé avec ES2018 et peut être décrit de la façon suivante :</p> +La méthode `toString()` renvoie toujours une chaîne de caractères représentant une date en anglais américain. Ce format a été standardisé avec ES2018 et peut être décrit de la façon suivante : -<ul> - <li>Le jour de la semaine avec les trois premières lettres du jour en anglais (ex. « Sat »)</li> - <li>Un espace</li> - <li>Le mois avec les trois premières lettres du mois en anglais (ex. « Sep »)</li> - <li>Un espace</li> - <li>La date du jour dans le mois sur deux chiffres (ex. « 01 »)</li> - <li>Un espace</li> - <li>L'année sur 4 chiffres (ex. « 2018 »)</li> - <li>Un espace</li> - <li>L'heure sur deux chiffres (ex. « 14 »)</li> - <li>Un deux-points (:)</li> - <li>Les minutes sur deux chiffres (ex. « 53 »)</li> - <li>Un deux-points (:)</li> - <li>Les secondes sur deux chiffres (ex. « 26 »)</li> - <li>Un espace</li> - <li>La chaîne de caractères « GMT »</li> - <li>Le signe du décalage horaire par rapport à GMT : - <ul> - <li>La chaîne "+" pour les décalages positifs (0 ou plus)</li> - <li>La chaîne "-" pour les décalages strictement négatifs</li> - </ul> - </li> - <li>L'heure de décalage sur deux chiffres</li> - <li>Les minutes de décalage sur deux chiffres</li> - <li>Et, éventuellement, le nom du fuseau horaire avec - <ul> - <li>Un espace</li> - <li>Une parenthèse ouvrante (« ( »)</li> - <li>Une chaîne de caractères, pouvant varier selon l'implémentation, qui désigne le fuseau horaire. Ce peut être une abréviation ou un nom complet.</li> - <li>Une parenthèse fermante (« ) »)</li> - </ul> - </li> -</ul> +- Le jour de la semaine avec les trois premières lettres du jour en anglais (ex. « Sat ») +- Un espace +- Le mois avec les trois premières lettres du mois en anglais (ex. « Sep ») +- Un espace +- La date du jour dans le mois sur deux chiffres (ex. « 01 ») +- Un espace +- L'année sur 4 chiffres (ex. « 2018 ») +- Un espace +- L'heure sur deux chiffres (ex. « 14 ») +- Un deux-points (:) +- Les minutes sur deux chiffres (ex. « 53 ») +- Un deux-points (:) +- Les secondes sur deux chiffres (ex. « 26 ») +- Un espace +- La chaîne de caractères « GMT » +- Le signe du décalage horaire par rapport à GMT : -<p>Avant ES2018, le format de la chaîne de caractères renvoyé pouvait varier selon l'implémentation.</p> + - La chaîne "+" pour les décalages positifs (0 ou plus) + - La chaîne "-" pour les décalages strictement négatifs -<p>JavaScript appelle la méthode <code>toString()</code> automatiquement quand une date doit être representée sous forme d'un texte ou quand une date est référencée lors d'une concatenation de chaînes de caractères.</p> +- L'heure de décalage sur deux chiffres +- Les minutes de décalage sur deux chiffres +- Et, éventuellement, le nom du fuseau horaire avec -<p><code>toString()</code> est une méthode générique. Si <code>this</code> n'est pas une instance de {{jsxref("Date")}}, elle renverra "Invalid Date".</p> + - Un espace + - Une parenthèse ouvrante (« ( ») + - Une chaîne de caractères, pouvant varier selon l'implémentation, qui désigne le fuseau horaire. Ce peut être une abréviation ou un nom complet. + - Une parenthèse fermante (« ) ») -<h2 id="Exemples">Exemples</h2> +Avant ES2018, le format de la chaîne de caractères renvoyé pouvait varier selon l'implémentation. -<h3 id="Utiliser_toString()">Utiliser <code>toString()</code></h3> +JavaScript appelle la méthode `toString()` automatiquement quand une date doit être representée sous forme d'un texte ou quand une date est référencée lors d'une concatenation de chaînes de caractères. -<p>L'exemple suivant assigne la valeur de <code>toString()</code> de l'objet <code>Date</code> à <code>maVar</code> :</p> +`toString()` est une méthode générique. Si `this` n'est pas une instance de {{jsxref("Date")}}, elle renverra "Invalid Date". -<pre class="brush:js">var x = new Date(); +## Exemples + +### Utiliser `toString()` + +L'exemple suivant assigne la valeur de `toString()` de l'objet `Date` à `maVar` : + +```js +var x = new Date(); var maVar = x.toString(); // assigne une valeur à maVar similaire à : // Mon Sep 28 1998 14:36:22 GMT-0700 (PDT) -</pre> - -<h2 id="Spécifications">Spécifications</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.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.2', 'Date.prototype.toLocaleTimeString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.tostring', 'Date.prototype.toString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES2018', '#sec-date.prototype.tostring', 'Date.prototype.toString')}}</td> - <td>{{Spec2('ES2018')}}</td> - <td>Standardisation du format produit par <code>Date.prototype.toString()</code></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.tostring', 'Date.prototype.toString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Object.prototype.toString()")}}</li> - <li>{{jsxref("Date.prototype.toDateString()")}}</li> - <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> - <li>{{jsxref("Date.prototype.toTimeString()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | +| {{SpecName('ES5.1', '#sec-15.9.5.2', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.tostring', 'Date.prototype.toString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ES2018', '#sec-date.prototype.tostring', 'Date.prototype.toString')}} | {{Spec2('ES2018')}} | Standardisation du format produit par `Date.prototype.toString()` | +| {{SpecName('ESDraft', '#sec-date.prototype.tostring', 'Date.prototype.toString')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toString")}} + +## Voir aussi + +- {{jsxref("Object.prototype.toString()")}} +- {{jsxref("Date.prototype.toDateString()")}} +- {{jsxref("Date.prototype.toLocaleString()")}} +- {{jsxref("Date.prototype.toTimeString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/totimestring/index.md b/files/fr/web/javascript/reference/global_objects/date/totimestring/index.md index 8931f46e60..cabaa9ae84 100644 --- a/files/fr/web/javascript/reference/global_objects/date/totimestring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/totimestring/index.md @@ -10,76 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toTimeString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toTimeString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toTimeString()</strong></code>renvoie la partie « heure » de l'objet <code>Date</code> dans un format lisible par un humain, en anglais américain.</p> +La méthode **`toTimeString()`**renvoie la partie « heure » de l'objet `Date` dans un format lisible par un humain, en anglais américain. -<div>{{EmbedInteractiveExample("pages/js/date-totimestring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-totimestring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toTimeString()</pre> + dateObj.toTimeString() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères qui représente l'heure de la date indiquée dans un format anglais américain.</p> +Une chaîne de caractères qui représente l'heure de la date indiquée dans un format anglais américain. -<h2 id="Description">Description</h2> +## Description -<p>Une instance de {{jsxref("Date")}} représente un instant précis dans le temps. Appeler {{jsxref("Date.toString", "toString()")}} renverra la date formatée de façon à être lisible par un humain, en anglais américain. Pour le moteur JavaScript <a href="/fr/docs/SpiderMonkey">SpiderMonkey</a>, ceci consiste en la partie « date » (jour, mois, année) suivie de la partie « heure » (heures, minutes, secondes, et fuseau horaire). Parfois, il est préférable d'obtenir seulement la partie « heure » ; c'est ce que renvoie la méthode <code>toTimeString().</code></p> +Une instance de {{jsxref("Date")}} représente un instant précis dans le temps. Appeler {{jsxref("Date.toString", "toString()")}} renverra la date formatée de façon à être lisible par un humain, en anglais américain. Pour le moteur JavaScript [SpiderMonkey](/fr/docs/SpiderMonkey), ceci consiste en la partie « date » (jour, mois, année) suivie de la partie « heure » (heures, minutes, secondes, et fuseau horaire). Parfois, il est préférable d'obtenir seulement la partie « heure » ; c'est ce que renvoie la méthode `toTimeString().` -<p>La méthode <code>toTimeString()</code> est particulièrement utile parce que les moteurs implémentant <a href="/fr/docs/JavaScript/Language_Resources">ECMA-262</a> peuvent obtenir des résultats différents avec la méthode {{jsxref("Date.prototype.toString()", "toString()")}} (en effet, le format dépend de l'implémentation). Ceci peut empêcher les manipulations de textes simples d'avoir des résultats cohérents au sein des différents moteurs/navigateurs.</p> +La méthode `toTimeString()` est particulièrement utile parce que les moteurs implémentant [ECMA-262](/fr/docs/JavaScript/Language_Resources) peuvent obtenir des résultats différents avec la méthode {{jsxref("Date.prototype.toString()", "toString()")}} (en effet, le format dépend de l'implémentation). Ceci peut empêcher les manipulations de textes simples d'avoir des résultats cohérents au sein des différents moteurs/navigateurs. -<h2 id="Exemple">Exemple</h2> +## Exemple -<h3 id="Utiliser_toTimeString()">Utiliser <code>toTimeString()</code></h3> +### Utiliser `toTimeString()` -<pre class="brush:js">var d = new Date(1993, 6, 28, 14, 39, 7); +```js +var d = new Date(1993, 6, 28, 14, 39, 7); console.log(d.toString()); // Wed Jul 28 1993 14:39:07 GMT-0600 (PDT) console.log(d.toTimeString()); // 14:39:07 GMT-0600 (PDT) -</pre> - -<h2 id="Spécifications">Spécifications</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('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.4', 'Date.prototype.toTimeString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.totimestring', 'Date.prototype.toTimeString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.totimestring', 'Date.prototype.toTimeString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toTimeString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> - <li>{{jsxref("Date.prototype.toDateString()")}}</li> - <li>{{jsxref("Date.prototype.toString()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. | +| {{SpecName('ES5.1', '#sec-15.9.5.4', 'Date.prototype.toTimeString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.totimestring', 'Date.prototype.toTimeString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.totimestring', 'Date.prototype.toTimeString')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toTimeString")}} + +## Voir aussi + +- {{jsxref("Date.prototype.toLocaleTimeString()")}} +- {{jsxref("Date.prototype.toDateString()")}} +- {{jsxref("Date.prototype.toString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/toutcstring/index.md b/files/fr/web/javascript/reference/global_objects/date/toutcstring/index.md index fb08c111a8..b7db523967 100644 --- a/files/fr/web/javascript/reference/global_objects/date/toutcstring/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/toutcstring/index.md @@ -10,80 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/toUTCString original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toUTCString --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>toUTCString()</strong></code> convertit une date en une chaîne de caractères, selon le fuseau horaire UTC.</p> +La méthode **`toUTCString()`** convertit une date en une chaîne de caractères, selon le fuseau horaire UTC. -<div>{{EmbedInteractiveExample("pages/js/date-toutcstring.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-toutcstring.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>dateObj</var>.toUTCString()</pre> + dateObj.toUTCString() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une chaîne de caractères représentant la date indiquée selon le fuseau horaire UTC.</p> +Une chaîne de caractères représentant la date indiquée selon le fuseau horaire UTC. -<h2 id="Description">Description</h2> +## Description -<p>La valeur renvoyée par <code>toUTCString()</code> est un texte au même format que celui renvoyé {{jsxref("Date.prototype.toString()")}} mais sans décalage de fuseau horaire (en UTC).</p> +La valeur renvoyée par `toUTCString()` est un texte au même format que celui renvoyé {{jsxref("Date.prototype.toString()")}} mais sans décalage de fuseau horaire (en UTC). -<p>Avant ECMAScript 2018, le format de la valeur renvoyée pouvait varier selon les plateformes. La valeur la plus couramment renvoyée était une date formatée selon la RFC 1123, qui est une version mise à jour de la RFC 822.</p> +Avant ECMAScript 2018, le format de la valeur renvoyée pouvait varier selon les plateformes. La valeur la plus couramment renvoyée était une date formatée selon la RFC 1123, qui est une version mise à jour de la RFC 822. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_toUTCString()">Utiliser <code>toUTCString()</code></h3> +### Utiliser `toUTCString()` -<pre class="brush: js">var aujourdhui = new Date(); +```js +var aujourdhui = new Date(); var UTCstring = aujourdhui.toUTCString(); // Mon, 03 Jul 2006 21:44:38 GMT -</pre> - -<h2 id="Spécifications">Spécifications</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. Le format dépend de l'implémentation.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.42', 'Date.prototype.toUTCString')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES2018', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}}</td> - <td>{{Spec2('ES2018')}}</td> - <td>Première standardisation du format</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.toUTCString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> - <li>{{jsxref("Date.prototype.toDateString()")}}</li> - <li>{{jsxref("Date.prototype.toISOString()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.3. Le format dépend de l'implémentation. | +| {{SpecName('ES5.1', '#sec-15.9.5.42', 'Date.prototype.toUTCString')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}} | {{Spec2('ES6')}} | | +| {{SpecName('ES2018', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}} | {{Spec2('ES2018')}} | Première standardisation du format | +| {{SpecName('ESDraft', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.toUTCString")}} + +## Voir aussi + +- {{jsxref("Date.prototype.toLocaleString()")}} +- {{jsxref("Date.prototype.toDateString()")}} +- {{jsxref("Date.prototype.toISOString()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/utc/index.md b/files/fr/web/javascript/reference/global_objects/date/utc/index.md index 8caed69035..6dbf12f938 100644 --- a/files/fr/web/javascript/reference/global_objects/date/utc/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/utc/index.md @@ -9,126 +9,99 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC original_slug: Web/JavaScript/Reference/Objets_globaux/Date/UTC --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>Date.UTC()</code></strong> accepte des paramètres similaires à ceux du constructeur {{jsxref("Date")}} et renvoie le nombre de millièmes de seconde depuis le 1er janvier 1970, 00:00:00, temps universel. Autrement dit, elle renvoie la date en UTC.</p> +La méthode **`Date.UTC()`** accepte des paramètres similaires à ceux du constructeur {{jsxref("Date")}} et renvoie le nombre de millièmes de seconde depuis le 1er janvier 1970, 00:00:00, temps universel. Autrement dit, elle renvoie la date en UTC. -<div>{{EmbedInteractiveExample("pages/js/date-utc.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-utc.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">Date.UTC(<em>année</em>[,<em>mois</em>[,<em>jour</em>[,<em>heures</em>[,<em>minutes</em>[,<em>secondes</em>[,<em>ms</em>]]]]]])</pre> + Date.UTC(année[,mois[,jour[,heures[,minutes[,secondes[,ms]]]]]]) -<h2 id="Paramètres">Paramètres</h2> +## Paramètres -<dl> - <dt><code>année</code></dt> - <dd>Une année sur deux chiffres pour une année après 1900 (ex. 98 pour 1998) ou bien une année sur quatre chiffres (2018).</dd> - <dt><code>mois</code>{{optional_inline}}</dt> - <dd> - <p>Un entier entre 0 (janvier) et 11 (décembre) représentant le mois.</p> +- `année` + - : Une année sur deux chiffres pour une année après 1900 (ex. 98 pour 1998) ou bien une année sur quatre chiffres (2018). +- `mois`{{optional_inline}} - <div class="note"><p><strong>Note :</strong> Cet argument est optionnel depuis ECMAScript 2017.</p></div> - </dd> - <dt><code>jour</code>{{optional_inline}}</dt> - <dd>Un entier entre 1 et 31 représentant le jour du mois. La valeur par défaut vaut 1.</dd> - <dt><code>heures</code>{{optional_inline}}</dt> - <dd>Paramètre optionnel, un entier entre 0 et 23 représentant les heures. La valeur par défaut vaut 0.</dd> - <dt><code>minutes</code>{{optional_inline}}</dt> - <dd>Paramètre optionnel, un entier entre 0 et 59 représentant les minutes. La valeur par défaut vaut 0.</dd> - <dt><code>secondes</code>{{optional_inline}}</dt> - <dd>Paramètre optionnel, un entier entre 0 et 59 représentant les secondes. La valeur par défaut vaut 0.</dd> - <dt><code>ms</code>{{optional_inline}}</dt> - <dd>Paramètre optionnel, un entier entre 0 et 999 représentant les millièmes de seconde. La valeur par défaut vaut 0.</dd> -</dl> + - : Un entier entre 0 (janvier) et 11 (décembre) représentant le mois. -<h3 id="Valeur_de_retour">Valeur de retour</h3> + > **Note :** Cet argument est optionnel depuis ECMAScript 2017. -<p>Un nombre représentant le nombre de millisecondes écoulées entre la date indiquée et le premier janvier 1970 à minuit UTC.</p> +- `jour`{{optional_inline}} + - : Un entier entre 1 et 31 représentant le jour du mois. La valeur par défaut vaut 1. +- `heures`{{optional_inline}} + - : Paramètre optionnel, un entier entre 0 et 23 représentant les heures. La valeur par défaut vaut 0. +- `minutes`{{optional_inline}} + - : Paramètre optionnel, un entier entre 0 et 59 représentant les minutes. La valeur par défaut vaut 0. +- `secondes`{{optional_inline}} + - : Paramètre optionnel, un entier entre 0 et 59 représentant les secondes. La valeur par défaut vaut 0. +- `ms`{{optional_inline}} + - : Paramètre optionnel, un entier entre 0 et 999 représentant les millièmes de seconde. La valeur par défaut vaut 0. -<h2 id="Description">Description</h2> +### Valeur de retour -<p>La méthode <code>UTC</code> prend des paramètres de date et d'heure séparés par des virgules et renvoie le nombre de millièmes de seconde entre le 1er janvier 1970, 00:00:00, temps universel et la date et l'heure spécifiées.</p> +Un nombre représentant le nombre de millisecondes écoulées entre la date indiquée et le premier janvier 1970 à minuit UTC. -<p>Il faut spécifier l'année entière pour le premier paramètre ; par exemple 1998. Si l'année spécifiée est entre 0 et 99, la méthode la convertira en une année du XXe siècle (1900 + année) ; par exemple si vous indiquez 95, l'année 1995 sera utilisée.</p> +## Description -<p>La méthode <code>UTC</code> diffère du constructeur {{jsxref("Date")}} pour deux raisons :</p> +La méthode `UTC` prend des paramètres de date et d'heure séparés par des virgules et renvoie le nombre de millièmes de seconde entre le 1er janvier 1970, 00:00:00, temps universel et la date et l'heure spécifiées. -<ul> - <li><code>Date.UTC</code> utilise le temps universel plutôt que l'heure locale.</li> - <li><code>Date.UTC</code> renvoie une valeur temporelle sous la forme d'un nombre plutôt que de créer un objet <code>Date</code>.</li> -</ul> +Il faut spécifier l'année entière pour le premier paramètre ; par exemple 1998. Si l'année spécifiée est entre 0 et 99, la méthode la convertira en une année du XXe siècle (1900 + année) ; par exemple si vous indiquez 95, l'année 1995 sera utilisée. -<p>Si un paramètre spécifié est en dehors des limites attendues, la méthode <code>UTC</code> met à jour les autres paramètres pour s'adapter à ce nombre. Par exemple, si vous utilisez 15 pour le mois, l'année sera incrémentée d'une unité (année + 1), et la valeur 3 (avril) sera utilisée pour le mois.</p> +La méthode `UTC` diffère du constructeur {{jsxref("Date")}} pour deux raisons : -<p>Comme <code>UTC</code> est une méthode statique de <code>Date</code>, on l'utilise toujours sous la forme <code>Date.UTC()</code> plutôt que comme une méthode d'un objet <code>Date</code> que vous auriez créé.</p> +- `Date.UTC` utilise le temps universel plutôt que l'heure locale. +- `Date.UTC` renvoie une valeur temporelle sous la forme d'un nombre plutôt que de créer un objet `Date`. -<h2 id="Exemples">Exemples</h2> +Si un paramètre spécifié est en dehors des limites attendues, la méthode `UTC` met à jour les autres paramètres pour s'adapter à ce nombre. Par exemple, si vous utilisez 15 pour le mois, l'année sera incrémentée d'une unité (année + 1), et la valeur 3 (avril) sera utilisée pour le mois. -<h3 id="Utiliser_Date.UTC()">Utiliser <code>Date.UTC()</code></h3> +Comme `UTC` est une méthode statique de `Date`, on l'utilise toujours sous la forme `Date.UTC()` plutôt que comme une méthode d'un objet `Date` que vous auriez créé. -<p>L'instruction qui suit crée un objet <code>Date</code> en utilisant l'heure UTC plutôt que l'heure locale :</p> +## Exemples -<pre class="brush: js">var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0)); -</pre> +### Utiliser `Date.UTC()` -<h2 id="Spécifications">Spécifications</h2> +L'instruction qui suit crée un objet `Date` en utilisant l'heure UTC plutôt que l'heure locale : -<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('ESDraft', '#sec-date.utc', 'Date.UTC')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Le paramètre pour le mois est devenu optionnel avec ES2017.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Définition initiale. Implémentée avec JavaScript 1.0.</td> - </tr> - </tbody> -</table> +```js +var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0)); +``` -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Spécifications -<p>{{Compat("javascript.builtins.Date.UTC")}}</p> +| Spécification | État | Commentaires | +| -------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------------- | +| {{SpecName('ESDraft', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ESDraft')}} | Le paramètre pour le mois est devenu optionnel avec ES2017. | +| {{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ES6')}} | | +| {{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | -<h2 id="Notes_de_compatibilité">Notes de compatibilité</h2> +## Compatibilité des navigateurs -<h3 id="Utiliser_Date.UTC_avec_moins_de_deux_arguments">Utiliser <code>Date.UTC</code> avec moins de deux arguments</h3> +{{Compat("javascript.builtins.Date.UTC")}} -<p>Lorsqu'on fournit moins de deux arguments à <code>Date.UTC</code>, {{jsxref("NaN")}} sera renvoyé. Ce comportement a été spécifié dans ECMAScript 2017 et les moteurs qui n'obéissaient pas à cette règle on été mis à jour (cf. {{bug(1050755)}}, <a href="https://github.com/tc39/ecma262/pull/642">ecma-262 #642</a>).</p> +## Notes de compatibilité -<pre class="brush: js">Date.UTC(); +### Utiliser `Date.UTC` avec moins de deux arguments + +Lorsqu'on fournit moins de deux arguments à `Date.UTC`, {{jsxref("NaN")}} sera renvoyé. Ce comportement a été spécifié dans ECMAScript 2017 et les moteurs qui n'obéissaient pas à cette règle on été mis à jour (cf. {{bug(1050755)}}, [ecma-262 #642](https://github.com/tc39/ecma262/pull/642)). + +```js +Date.UTC(); Date.UTC(1); // Safari: NaN // Chrome/Opera/V8: NaN -// Firefox <54: non-NaN +// Firefox <54: non-NaN // Firefox 54+: NaN // IE: non-NaN // Edge: NaN -</pre> +``` -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("Date.parse()")}}</li> -</ul> +- {{jsxref("Date.parse()")}} diff --git a/files/fr/web/javascript/reference/global_objects/date/valueof/index.md b/files/fr/web/javascript/reference/global_objects/date/valueof/index.md index fb835f4c3b..684d275338 100644 --- a/files/fr/web/javascript/reference/global_objects/date/valueof/index.md +++ b/files/fr/web/javascript/reference/global_objects/date/valueof/index.md @@ -10,75 +10,51 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Date/valueOf original_slug: Web/JavaScript/Reference/Objets_globaux/Date/valueOF --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <strong><code>valueOf()</code></strong> renvoie la valeur primitive d'un objet {{jsxref("Date")}}.</p> +La méthode **`valueOf()`** renvoie la valeur primitive d'un objet {{jsxref("Date")}}. -<div>{{EmbedInteractiveExample("pages/js/date-valueof.html")}}</div> +{{EmbedInteractiveExample("pages/js/date-valueof.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>date</var>.valueOf()</pre> + date.valueOf() -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nombre de millisecondes écoulées entre le premier janvier 1970, minuit UTC et la date indiquée.</p> +Le nombre de millisecondes écoulées entre le premier janvier 1970, minuit UTC et la date indiquée. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>valueOf()</code> renvoie la valeur primitive d'un objet <code>Date</code> sous forme d'un nombre. Ce nombre correspond au nombre de millisecondes écoulées depuis le 1 janvier 1970 00h00 GMT.</p> +La méthode `valueOf()` renvoie la valeur primitive d'un objet `Date` sous forme d'un nombre. Ce nombre correspond au nombre de millisecondes écoulées depuis le 1 janvier 1970 00h00 GMT. -<p>D'un point de vue fonctionnel, cette méthode est équivalente à {{jsxref("Date.prototype.getTime()")}}.</p> +D'un point de vue fonctionnel, cette méthode est équivalente à {{jsxref("Date.prototype.getTime()")}}. -<p>Cette méthode est souvent appelée en interne par le moteur JavaScript et n'est pas utilisée de façon explicite dans des scripts.</p> +Cette méthode est souvent appelée en interne par le moteur JavaScript et n'est pas utilisée de façon explicite dans des scripts. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utiliser_valueOf()">Utiliser <code>valueOf()</code></h3> +### Utiliser `valueOf()` -<pre class="brush:js">var x = new Date(56, 6, 17); +```js +var x = new Date(56, 6, 17); var maVar = x.valueOf(); // maVar vaut -424713600000 -</pre> - -<h2 id="Spécifications">Spécifications</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.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5.8', 'Date.prototype.valueOf')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-date.prototype.valueof', 'Date.prototype.valueOf')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-date.prototype.valueof', 'Date.prototype.valueOf')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.Date.valueOf")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("Object.prototype.valueOf()")}}</li> - <li>{{jsxref("Date.prototype.getTime()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.1. | +| {{SpecName('ES5.1', '#sec-15.9.5.8', 'Date.prototype.valueOf')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-date.prototype.valueof', 'Date.prototype.valueOf')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-date.prototype.valueof', 'Date.prototype.valueOf')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Date.valueOf")}} + +## Voir aussi + +- {{jsxref("Object.prototype.valueOf()")}} +- {{jsxref("Date.prototype.getTime()")}} |