From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../global_objects/date/@@toprimitive/index.md | 58 ++-- .../reference/global_objects/date/getdate/index.md | 92 ++--- .../reference/global_objects/date/getday/index.md | 109 +++--- .../global_objects/date/getfullyear/index.md | 90 ++--- .../global_objects/date/gethours/index.md | 86 ++--- .../global_objects/date/getmilliseconds/index.md | 86 ++--- .../global_objects/date/getminutes/index.md | 86 ++--- .../global_objects/date/getmonth/index.md | 107 +++--- .../global_objects/date/getseconds/index.md | 86 ++--- .../reference/global_objects/date/gettime/index.md | 114 +++---- .../global_objects/date/gettimezoneoffset/index.md | 66 ++-- .../global_objects/date/getutcdate/index.md | 88 ++--- .../global_objects/date/getutcday/index.md | 88 ++--- .../global_objects/date/getutcfullyear/index.md | 75 ++-- .../global_objects/date/getutchours/index.md | 86 ++--- .../date/getutcmilliseconds/index.md | 90 ++--- .../global_objects/date/getutcminutes/index.md | 86 ++--- .../global_objects/date/getutcmonth/index.md | 86 ++--- .../global_objects/date/getutcseconds/index.md | 86 ++--- .../reference/global_objects/date/getyear/index.md | 139 ++++---- .../reference/global_objects/date/index.md | 376 ++++++++++----------- .../reference/global_objects/date/now/index.md | 98 +++--- .../reference/global_objects/date/parse/index.md | 216 ++++++------ .../reference/global_objects/date/setdate/index.md | 101 +++--- .../global_objects/date/setfullyear/index.md | 108 +++--- .../global_objects/date/sethours/index.md | 115 +++---- .../global_objects/date/setmilliseconds/index.md | 96 ++---- .../global_objects/date/setminutes/index.md | 110 +++--- .../global_objects/date/setmonth/index.md | 120 +++---- .../global_objects/date/setseconds/index.md | 106 +++--- .../reference/global_objects/date/settime/index.md | 96 ++---- .../global_objects/date/setutcdate/index.md | 96 ++---- .../global_objects/date/setutcfullyear/index.md | 106 +++--- .../global_objects/date/setutchours/index.md | 110 +++--- .../date/setutcmilliseconds/index.md | 96 ++---- .../global_objects/date/setutcminutes/index.md | 106 +++--- .../global_objects/date/setutcmonth/index.md | 102 +++--- .../global_objects/date/setutcseconds/index.md | 102 +++--- .../reference/global_objects/date/setyear/index.md | 100 ++---- .../global_objects/date/todatestring/index.md | 103 +++--- .../global_objects/date/togmtstring/index.md | 90 ++--- .../global_objects/date/toisostring/index.md | 94 +++--- .../reference/global_objects/date/tojson/index.md | 84 ++--- .../date/tolocaledatestring/index.md | 154 ++++----- .../global_objects/date/tolocalestring/index.md | 169 ++++----- .../date/tolocaletimestring/index.md | 154 ++++----- .../global_objects/date/tosource/index.md | 48 ++- .../global_objects/date/tostring/index.md | 169 ++++----- .../global_objects/date/totimestring/index.md | 92 ++--- .../global_objects/date/toutcstring/index.md | 98 ++---- .../reference/global_objects/date/utc/index.md | 141 ++++---- .../reference/global_objects/date/valueof/index.md | 92 ++--- 52 files changed, 2191 insertions(+), 3461 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/date') 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode [@@toPrimitive]() permet de convertir un objet Date en une valeur primitive.

+La méthode **`[@@toPrimitive]()`** permet de convertir un objet `Date` en une valeur primitive. -

Syntaxe

+## Syntaxe -
Date()[Symbol.toPrimitive](hint);
-
+ Date()[Symbol.toPrimitive](hint); -

Valeur de retour

+### Valeur de retour -

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.

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

Description

+## Description -

La méthode [@@toPrimitive]() de {{jsxref("Date")}} renvoie une valeur primitive qui est un nombre ou une chaîne de caractère.

+La méthode `[@@toPrimitive]()` de {{jsxref("Date")}} renvoie une valeur primitive qui est un nombre ou une chaîne de caractère. -

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")}}.

+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")}}. -

Si le paramètre hint vaut "number", [@@toPrimitive]() tentera d'abord un appel à valueOf() puis ensuite un appel à toString().

+Si le paramètre `hint` vaut `"number"`, `[@@toPrimitive]()` tentera d'abord un appel à `valueOf()` puis ensuite un appel à `toString()`. -

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.

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

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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')}} 
+| 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')}} |   | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("javascript.builtins.Date.@@toPrimitive")}}

+{{Compat("javascript.builtins.Date.@@toPrimitive")}} -

Voir aussi

+## Voir aussi - +- {{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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getDate() retourne le jour du mois pour la date spécifiée d'après l'heure locale.

+La méthode **`getDate()`** retourne le jour du mois pour la date spécifiée d'après l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-getdate.html")}}
+{{EmbedInteractiveExample("pages/js/date-getdate.html")}} -

Syntaxe

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

Paramètres

+### Paramètres -

Aucun.

+Aucun. -

Valeur de retour

+### Valeur de retour -

Un entier entre 1 et 31 correspondant au jour du mois de la date indiquée selon l'heure locale.

+Un entier entre 1 et 31 correspondant au jour du mois de la date indiquée selon l'heure locale. -

Exemples

+## Exemples -

Utiliser getDate()

+### Utiliser `getDate()` -

La seconde instruction ci-dessous affecte la valeur 25 à la variable jour, d'après la valeur de l'objet {{jsxref("Date")}} Noel95.

+La seconde instruction ci-dessous affecte la valeur 25 à la variable `jour`, d'après la valeur de l'objet {{jsxref("Date")}} `Noel95`. -
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
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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()")}}.

+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()")}}. -
{{EmbedInteractiveExample("pages/js/date-getday.html")}}
+{{EmbedInteractiveExample("pages/js/date-getday.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

Exemples

+## Exemples -

Utiliser getDay()

+### Utiliser `getDay()` -

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.

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

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 :

- -
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ÉtatCommentaires
{{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

- - +``` + +> **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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getFullYear() renvoie l'année de la date renseignée d'après l'heure locale.

+La méthode **`getFullYear()`** renvoie l'année de la date renseignée d'après l'heure locale. -

Cette méthode doit être utilisée à la place de {{jsxref("Date.prototype.getYear()", "getYear()")}}.

+Cette méthode doit être utilisée à la place de {{jsxref("Date.prototype.getYear()", "getYear()")}}. -
{{EmbedInteractiveExample("pages/js/date-getfullyear.html")}}
+{{EmbedInteractiveExample("pages/js/date-getfullyear.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un entier correspondant à l'année de la date selon l'heure locale.

+Un entier correspondant à l'année de la date selon l'heure locale. -

Exemples

+## Exemples -

Utiliser getFullYear()

+### Utiliser `getFullYear()` -

L'exemple qui suit assigne la valeur à quatre chiffres de l'année courante à la variable année.

+L'exemple qui suit assigne la valeur à quatre chiffres de l'année courante à la variable `année`. -
var aujd = new Date();
+```js
+var aujd = new Date();
 var année = aujd.getFullYear();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getHours() renvoie l'heure pour la date renseignée, d'après l'heure locale.

+La méthode **`getHours()`** renvoie l'heure pour la date renseignée, d'après l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-gethours.html")}}
+{{EmbedInteractiveExample("pages/js/date-gethours.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un entier, compris entre 0 et 23 qui indique l'heure de la date indiquée selon l'heure locale.

+Un entier, compris entre 0 et 23 qui indique l'heure de la date indiquée selon l'heure locale. -

Exemples

+## Exemples -

Utiliser getHours()

+### Utiliser `getHours()` -

La seconde instruction ci-dessous assigne la valeur 23 à la variable heure, selon la valeur de l'objet {{jsxref("Date")}} noel95.

+La seconde instruction ci-dessous assigne la valeur 23 à la variable `heure`, selon la valeur de l'objet {{jsxref("Date")}} `noel95`. -
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
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getMilliseconds() renvoie les millièmes de secondes de la date renseignée d'après l'heure locale.

+La méthode **`getMilliseconds()`** renvoie les millièmes de secondes de la date renseignée d'après l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-getmilliseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-getmilliseconds.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un nombre entre 0 et 999 indiquant le nombre de millisecondes pour la date indiquée, selon l'heure locale.

+Un nombre entre 0 et 999 indiquant le nombre de millisecondes pour la date indiquée, selon l'heure locale. -

Exemples

+## Exemples -

Utiliser getMilliseconds()

+### Utiliser `getMilliseconds()` -

L'exemple suivant assigne la partie des millièmes de secondes de l'heure courante à la variable ms.

+L'exemple suivant assigne la partie des millièmes de secondes de l'heure courante à la variable `ms`. -
var aujd = new Date();
+```js
+var aujd = new Date();
 var ms = aujd.getMilliseconds();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getMinutes() renvoie les minutes pour la date renseignée d'après l'heure locale.

+La méthode **`getMinutes()`** renvoie les minutes pour la date renseignée d'après l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-getminutes.html")}}
+{{EmbedInteractiveExample("pages/js/date-getminutes.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

Exemples

+## Exemples -

Utiliser getMinutes()

+### Utiliser `getMinutes()` -

La seconde instruction ci-dessous assigne la valeur 15 à la variable minutes, selon la valeur de l'objet {{jsxref("Date")}} noel95.

+La seconde instruction ci-dessous assigne la valeur 15 à la variable `minutes`, selon la valeur de l'objet {{jsxref("Date")}} `noel95`. -
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
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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).

+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). -
{{EmbedInteractiveExample("pages/js/date-getmonth.html")}}
+{{EmbedInteractiveExample("pages/js/date-getmonth.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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).

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

Exemples

+## Exemples -

Utiliser getMonth()

+### Utiliser `getMonth()` -

La seconde instruction ci-dessous assigne la valeur 11 à la variable mois, d'après la valeur de l'objet {{jsxref("Date")}} noel95.

+La seconde instruction ci-dessous assigne la valeur 11 à la variable `mois`, d'après la valeur de l'objet {{jsxref("Date")}} `noel95`. -
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
-
- -
-

Note : Si besoin, on pourra récupérer le nom complet du mois ("Janvier" par exemple) en utilisant Intl.DateTimeFormat() avec un paramètre options. En utilisant cette méthode, il est plus simple d'internationaliser le site ou l'application :

- -
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ÉtatCommentaires
{{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

- - +``` + +> **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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getSeconds() renvoie les secondes pour la date renseignée d'après l'heure locale.

+La méthode **`getSeconds()`** renvoie les secondes pour la date renseignée d'après l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-getseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-getseconds.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

Exemples

+## Exemples -

Utiliser getSeconds()

+### Utiliser `getSeconds()` -

La seconde instruction ci-dessous assigne la valeur 30 à la variable secondes, selon la valeur de l'objet {{jsxref("Date")}} noel95.

+La seconde instruction ci-dessous assigne la valeur 30 à la variable `secondes`, selon la valeur de l'objet {{jsxref("Date")}} `noel95`. -
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
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

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

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()")}}.

+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()")}}. -
{{EmbedInteractiveExample("pages/js/date-gettime.html")}}
+{{EmbedInteractiveExample("pages/js/date-gettime.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

Exemples

+## Exemples -

Utiliser getTime()

+### Utiliser `getTime()` -

L'exemple qui suit assigne la valeur de anniversaire à copie :

+L'exemple qui suit assigne la valeur de `anniversaire` à `copie` : -
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());
-
+``` -

Mesurer un temps d'exécution

+### Mesurer un temps d'exécution -

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).

+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). -
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');
-
+``` -

Précision temporelle réduite

+## Précision temporelle réduite -

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.

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

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ÉtatCommentaires
{{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

- - +``` + +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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getTimezoneOffset() retourne la différence en minutes entre le fuseau horaire UTC, et celui de l'heure locale.

+La méthode **`getTimezoneOffset()`** retourne la différence en minutes entre le fuseau horaire UTC, et celui de l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-gettimezoneoffset.html")}}
+{{EmbedInteractiveExample("pages/js/date-gettimezoneoffset.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser getTimezoneOffset()

+### Utiliser `getTimezoneOffset()` -
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;
-
+``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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')}} 
+| 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')}} |   | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

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

+{{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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getUTCDate() renvoie le jour du mois pour la date renseignée d'après UTC.

+La méthode **`getUTCDate()`** renvoie le jour du mois pour la date renseignée d'après UTC. -
{{EmbedInteractiveExample("pages/js/date-getutcdate.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcdate.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

Exemples

+## Exemples -

Utiliser getUTCDate()

+### Utiliser `getUTCDate()` -

L'exemple suivant assigne le jour du mois pour la date actuelle, à la variable jour.

+L'exemple suivant assigne le jour du mois pour la date actuelle, à la variable `jour`. -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var jour = aujourdhui.getUTCDate();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-getutcday.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcday.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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).

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

Exemples

+## Exemples -

Utiliser getUTCDay()

+### Utiliser `getUTCDay()` -

L'exemple suivant assigne le jour de la semaine de la date actuelle à la variable jourSemaine.

+L'exemple suivant assigne le jour de la semaine de la date actuelle à la variable `jourSemaine`. -
var aujourdhui = new Date()
+```js
+var aujourdhui = new Date()
 var jourSemaine = aujourdhui.getUTCDay()
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getUTCFullYear() renvoie l'année de la date renseignée, d'après UTC.

+La méthode **`getUTCFullYear()`** renvoie l'année de la date renseignée, d'après UTC. -
{{EmbedInteractiveExample("pages/js/date-getutcfullyear.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcfullyear.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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.

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

Exemples

+## Exemples -

Utiliser getUTCFullYear()

+### Utiliser `getUTCFullYear()` -

L'exemple suivant assigne une valeur à 4 chiffres, l'année courante, à la variable annee.

+L'exemple suivant assigne une valeur à 4 chiffres, l'année courante, à la variable `annee`. -
var aujourdhui = new Date();
-var annee = aujourdhui.getUTCFullYear();
+```js +var aujourdhui = new Date(); +var annee = aujourdhui.getUTCFullYear(); +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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')}} 
+| 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')}} |   | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

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

+{{Compat("javascript.builtins.Date.getUTCFullYear")}} -

Voir aussi

+## Voir aussi - +- {{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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getUTCHours() renvoie les heures de la date renseignée, d'après UTC.

+La méthode **`getUTCHours()`** renvoie les heures de la date renseignée, d'après UTC. -
{{EmbedInteractiveExample("pages/js/date-getutchours.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutchours.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un entier entre 0 et 23 correspondant à l'heure de la date indiquée selon le temps universel.

+Un entier entre 0 et 23 correspondant à l'heure de la date indiquée selon le temps universel. -

Exemples

+## Exemples -

Utiliser getUTCHours()

+### Utiliser `getUTCHours()` -

L'exemple suivant assigne les heures de la date actuelle à la variable heures.

+L'exemple suivant assigne les heures de la date actuelle à la variable `heures`. -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var heures = aujourdhui.getUTCHours();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getUTCMilliseconds() renvoie les millièmes de secondes pour la date renseignée selon UTC.

+La méthode **`getUTCMilliseconds()`** renvoie les millièmes de secondes pour la date renseignée selon UTC. -
{{EmbedInteractiveExample("pages/js/date-getutcmilliseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcmilliseconds.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un entier entre 0 et 999 correspondant au nombre de millisecondes pour la date indiquée, selon le temps universel.

+Un entier entre 0 et 999 correspondant au nombre de millisecondes pour la date indiquée, selon le temps universel. -
-

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()")}}.

-
+> **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()")}}. -

Exemples

+## Exemples -

Utiliser getUTCMilliseconds()

+### Utiliser `getUTCMilliseconds()` -

L'exemple suivant assigne les millièmes de secondes pour la date actuelle à la variable ms.

+L'exemple suivant assigne les millièmes de secondes pour la date actuelle à la variable `ms`. -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var ms = aujourdhui.getUTCMilliseconds();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getUTCMinutes() renvoie les minutes de la date renseignée, d'après UTC.

+La méthode **`getUTCMinutes()`** renvoie les minutes de la date renseignée, d'après UTC. -
{{EmbedInteractiveExample("pages/js/date-getutcminutes.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcminutes.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un entier entre 0 et 59 correspondant au nombre de minutes pour la date indiquée selon le temps universel.

+Un entier entre 0 et 59 correspondant au nombre de minutes pour la date indiquée selon le temps universel. -

Exemples

+## Exemples -

Utiliser getUTCMinutes

+### Utiliser `getUTCMinutes` -

L'exemple suivant assigne les minutes de la date actuelle à la variable minutes.

+L'exemple suivant assigne les minutes de la date actuelle à la variable `minutes`. -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var minutes = aujourdhui.getUTCMinutes();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-getutcmonth.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcmonth.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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…).

+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…). -

Exemples

+## Exemples -

Utiliser getUTCMonth()

+### Utiliser `getUTCMonth()` -

L'exemple suivant assigne le mois de la date actuelle à la variable mois.

+L'exemple suivant assigne le mois de la date actuelle à la variable `mois`. -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var mois = aujourdhui.getUTCMonth();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode getUTCSeconds() renvoie les secondes de la date renseignée, d'après UTC.

+La méthode **`getUTCSeconds()`** renvoie les secondes de la date renseignée, d'après UTC. -
{{EmbedInteractiveExample("pages/js/date-getutcseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-getutcseconds.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Un entier entre 0 et 59 correspondant au nombre de secondes écoulées pour la date indiquée selon le temps universel.

+Un entier entre 0 et 59 correspondant au nombre de secondes écoulées pour la date indiquée selon le temps universel. -

Exemples

+## Exemples -

Utiliser getUTCSeconds()

+### Utiliser `getUTCSeconds()` -

L'exemple suivant assigne les secondes de la date actuelle à la variable secondes.

+L'exemple suivant assigne les secondes de la date actuelle à la variable `secondes`. -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var secondes = aujourdhui.getUTCSeconds();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}} {{Deprecated_header}}
+{{JSRef}} {{Deprecated_header}} -

La méthode getYear() renvoie l'année de la date renseignée, d'après l'heure locale. Parce que getYear() ne renvoie pas l'année complète (« bug de l'an 2000 »), cette méthode n'est plus utilisée et doit être remplacée par {{jsxref("Date.getFullYear", "getFullYear")}}.

+La méthode **`getYear()`** renvoie l'année de la date renseignée, d'après l'heure locale. Parce que `getYear()` ne renvoie pas l'année complète (« bug de l'an 2000 »), cette méthode n'est plus utilisée et doit être remplacée par {{jsxref("Date.getFullYear", "getFullYear")}}. -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

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

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

Description

+## Description -

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

+La méthode `getYear()` renvoie l'année moins 1900 ; par conséquent : - +- Pour les années supérieures ou égales à 2000, la valeur renvoyée par `getYear()` est supérieure ou égale à 100. Par exemple, si l'année est 2026, `getYear()` renvoie 126. +- Pour les années entre 1900 et 1999 incluses, la valeur renvoyée par `getYear()` est comprise entre 0 et 99. Par exemple, si l'année est 1976, `getYear()` renvoie 76. +- Pour les années inférieures à 1900, la valeur renvoyée par `getYear()` est négative. Par exemple, si l'année est 1800, `getYear()` renvoie -100. -

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

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

Rétrocompatibilité

+## Rétrocompatibilité -

Comportement dans JavaScript 1.2 et versions antérieures

+### Comportement dans JavaScript 1.2 et versions antérieures -

La méthode getYear() renvoyait soit une année en deux chiffres, soit une année en quatre chiffres :

+La méthode `getYear()` renvoyait soit une année en deux chiffres, soit une année en quatre chiffres : - +- Pour les années entre 1900 et 1999 incluses, la valeur renvoyée par `getYear()` était l'année moins 1900. Par exemple, si l'année était 1976, la valeur renvoyée était 76. +- Pour les années inférieures à 1900 ou supérieures à 1999, la valeur renvoyée par `getYear` était l'année en quatre chiffres. Par exemple, si l'année était 1856, la valeur renvoyée était 1856. Si l'année était 2026, la valeur renvoyée était 2026. -

Exemples

+## Exemples -

Années entre 1900 et 1999

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

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

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

Années après 1999

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

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

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

Années avant 1900

+### Années avant 1900 -

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

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

Définition et lecture d'une année entre 1900 et 1999

+### Définition et lecture d'une année entre 1900 et 1999 -

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

+La troisième instruction assigne la valeur 95 à la variable `annee`, représentant l'année 1995. -
var noel = new Date("December 25, 1800 23:15:00");
+```js
+var noel = new Date("December 25, 1800 23:15:00");
 var noel.setYear(95);
 var annee = noel.getYear(); // renvoie 95
-
- -

Specifications

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

Compatibilité des navigateurs

- -

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

- -

Voir aussi

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

- -

Note : TC39 travaille actuellement sur Temporal, une nouvelle API pour la gestion des dates, heures et données temporelles.
- Pour en savoir plus, consultez le blog d'Igalia et n'hésitez pas à répondre au sondage. 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 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.

-
- -
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)
-
+``` -

Les années sur deux chiffres correspondent à la période 1900 – 1999

+### Les années sur deux chiffres correspondent à la période 1900 – 1999 -

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()")}}.

+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()")}}. -
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)
-
+``` -

Calculer le temps écoulé

+### Calculer le temps écoulé -

Dans les exemples suivants, on illustre comment calculer le temps écoulé entre deux dates JavaScript en millisecondes.

+Dans les exemples suivants, on illustre comment calculer le temps écoulé entre deux dates JavaScript en millisecondes. -

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.

+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. -
// 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
-
+``` -
// 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
-
+``` -
// 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)
-
+``` -
-

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()")}}.

-
+> **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()")}}. -

Obtenir le nombre de secondes écoulées depuis l'epoch ECMAScript

+### Obtenir le nombre de secondes écoulées depuis l'epoch ECMAScript -
let secondes = Math.floor(Date.now() / 1000)
-
+```js +let secondes = Math.floor(Date.now() / 1000) +``` -

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.

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

Spécifications

+## Spécifications - - - - - - - - - - - -
Spécification
{{SpecName('ESDraft', '#sec-date-objects', 'Date')}}
+| Spécification | +| -------------------------------------------------------------------- | +| {{SpecName('ESDraft', '#sec-date-objects', 'Date')}} | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("javascript.builtins.Date", 3)}}

+{{Compat("javascript.builtins.Date", 3)}} -

Voir aussi

+## Voir aussi - +- 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode Date.now() renvoie le nombre de millisecondes écoulées depuis le 1er Janvier 1970 00:00:00 UTC.

+La méthode **`Date.now()`** renvoie le nombre de millisecondes écoulées depuis le 1er Janvier 1970 00:00:00 UTC. -
{{EmbedInteractiveExample("pages/js/date-now.html")}}
+{{EmbedInteractiveExample("pages/js/date-now.html")}} -

Syntaxe

+## Syntaxe -
var tempsEnMs = Date.now();
-
+ var tempsEnMs = Date.now(); -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC.

+Le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC. -

Description

+## Description -

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).

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

now() étant une méthode statique de {{jsxref("Date")}}, on utilisera toujours la forme Date.now().

+`now()` étant une méthode statique de {{jsxref("Date")}}, on utilisera toujours la forme `Date.now()`. -

Prothèse d'émulation (polyfill)

+## Prothèse d'émulation (_polyfill_) -

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 :

+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 : -
if (!Date.now) {
+```js
+if (!Date.now) {
   Date.now = function now() {
     return new Date().getTime();
   };
 }
-
+``` -

Précision temporelle réduite

+## Précision temporelle réduite -

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.

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

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ÉtatCommentaires
{{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

- - +``` + +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 --- -
{{JSRef}}
+{{JSRef}} -

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).

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

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.

-
+> **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. -
{{EmbedInteractiveExample("pages/js/date-parse.html")}}
+{{EmbedInteractiveExample("pages/js/date-parse.html")}} -

Syntaxe

+## Syntaxe -

Appel direct :

+Appel direct : -
Date.parse(dateString)
+ Date.parse(dateString) -

Appel implicite :

+Appel implicite : -
new Date(dateString)
+ new Date(dateString) -

Paramètres

+### Paramètres -
-
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).
-
+- `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). -

Valeur de retour

+### Valeur de retour -

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é.

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

Description

+## Description -

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")}}.

+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")}}. -

Format de la chaîne de caractères

+### Format de la chaîne de caractères -

À 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).

+À 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). -

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.

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

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.

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

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.

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

Différences entre les fuseaux horaires supposés

+### Différences entre les fuseaux horaires supposés -

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).

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

Traitement laissé libre à l'implémentation

+### Traitement laissé libre à l'implémentation -

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().

+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()`. -

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 :

+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 : -
// Chaîne non ISO avec des valeurs invalides
-new Date('23/25/2014');
+```js +// Chaîne non ISO avec des valeurs invalides +new Date('23/25/2014'); +``` -

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) :

+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) : -
// 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
+// renvoie "RangeError: invalid date" pour les navigateurs ES5 +``` -

L'implémentation spécifique de SpiderMonkey peut être trouvée dans le fichier jsdate.cpp. 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 pour une explication rapide de la façon dont est faite l'analyse de la chaîne.

+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. -
new Date('10 06 2014');
+```js +new Date('10 06 2014'); +``` -

sera traitée comme la date locale du 6 octobre 2014 et non comme le 10 juin 2014. D'autres exemples :

+sera traitée comme la date locale du 6 octobre 2014 et non comme le 10 juin 2014. D'autres exemples : -
new Date('toto-truc 2014').toString();
+```js
+new Date('toto-truc 2014').toString();
 // renvoie : "Invalid Date"
 Date.parse('toto-truc 2014');
-// renvoie : NaN
+// renvoie : NaN +``` -

Exemples

+## Exemples -

Utiliser Date.parse()

+### Utiliser `Date.parse()` -

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)

+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`) -
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")
-
+``` -

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é.

+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é. -
Date.parse("2019-01-01T00:00:00")
-
+```js +Date.parse("2019-01-01T00:00:00") +``` -

Chaînes de caractères non-standard

+### Chaînes de caractères non-standard -
-

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.

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

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 :

+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 : -
IPOdate.setTime(Date.parse('Aug 9, 1995'));
-
+```js +IPOdate.setTime(Date.parse('Aug 9, 1995')); +``` -

Voici un autre exemple avec une chaîne qui ne suit pas le format standard.

+Voici un autre exemple avec une chaîne qui ne suit pas le format standard. -
Date.parse('Aug 9, 1995');
-
+```js +Date.parse('Aug 9, 1995'); +``` -

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).

+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). -
Date.parse('Wed, 09 Aug 1995 00:00:00 GMT');
-
+```js +Date.parse('Wed, 09 Aug 1995 00:00:00 GMT'); +``` -

Renvoie 807926400000 quel que soit le fuseau local car on indique GMT.

+Renvoie `807926400000` quel que soit le fuseau local car on indique GMT. -
Date.parse('Wed, 09 Aug 1995 00:00:00');
-
+```js +Date.parse('Wed, 09 Aug 1995 00:00:00'); +``` -

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.

+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. -
Date.parse('Thu, 01 Jan 1970 00:00:00 GMT');
-
+```js +Date.parse('Thu, 01 Jan 1970 00:00:00 GMT'); +``` -

Renvoie 0 quel que soit le fuseau local car l'indicateur GMT est fourni.

+Renvoie `0` quel que soit le fuseau local car l'indicateur GMT est fourni. -
Date.parse('Thu, 01 Jan 1970 00:00:00');
-
+```js +Date.parse('Thu, 01 Jan 1970 00:00:00'); +``` -

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.

+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. -
Date.parse('Thu, 01 Jan 1970 00:00:00 GMT-0400');
-
+```js +Date.parse('Thu, 01 Jan 1970 00:00:00 GMT-0400'); +``` -

Renvoie 14400000 quel que soit le fuseau car l'indicateur GMT est fourni.

+Renvoie `14400000` quel que soit le fuseau car l'indicateur GMT est fourni. -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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')}}
+| 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')}} | | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

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

+{{Compat("javascript.builtins.Date.parse")}} -

Notes de compatibilité

+## Notes de compatibilité - +- À 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. -

Voir aussi

+## Voir aussi - +- {{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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setDate() définit le jour du mois (relatif au début du mois courant) pour une date donnée.

+La méthode **`setDate()`** définit le jour du mois (relatif au début du mois courant) pour une date donnée. -
{{EmbedInteractiveExample("pages/js/date-setdate.html")}}
+{{EmbedInteractiveExample("pages/js/date-setdate.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setDate(valeurJour)
+ dateObj.setDate(valeurJour) -

Paramètres

+### Paramètres -
-
valeurJour
-
Un entier représentant le jour du mois.
-
+- `valeurJour` + - : Un entier représentant le jour du mois. -

Valeur de retour

+### Valeur de retour -

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é).

+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é). -

Description

+## Description -

Si la valeurJour est en dehors des limites du mois courant, setDate() mettra à jour l'objet {{jsxref("Date")}} en conséquence.

+Si la `valeurJour` est en dehors des limites du mois courant, `setDate()` mettra à jour l'objet` `{{jsxref("Date")}} en conséquence. -

Par exemple, si 0 est fourni pour valeurJour, la date sera défini sur le dernier jour du mois précédent.

+Par exemple, si 0 est fourni pour `valeurJour`, la date sera défini sur le dernier jour du mois précédent. -

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.

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

Exemples

+## Exemples -

Utiliser setDate()

+### Utiliser `setDate()` -
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
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setFullYear() définit l'année complête pour une date, d'après l'heure locale.

+La méthode **`setFullYear()`** définit l'année complête pour une date, d'après l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-setfullyear.html")}}
+{{EmbedInteractiveExample("pages/js/date-setfullyear.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setFullYear(valeurAnnée[, valeurMois[, valeurJour]])
+ dateObj.setFullYear(valeurAnnée[, valeurMois[, valeurJour]]) -

Paramètres

+### Paramètres -
-
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.
-
+- `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`. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setFullYear()

+### Utiliser `setFullYear()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setFullYear(1997);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-sethours.html")}}
+{{EmbedInteractiveExample("pages/js/date-sethours.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]])
-
+ dateObj.setHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]]) -

Versions antérieures à JavaScript 1.3

+### Versions antérieures à JavaScript 1.3 -
dateObj.setHours(valeurHeures)
+ dateObj.setHours(valeurHeures) -

Paramètres

+### Paramètres -
-
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.
-
+- `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. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setHours()

+### Utiliser `setHours()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setHours(7);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setMilliseconds() définit les millièmes de secondes pour la date, selon l'heure locale.

+La méthode **`setMilliseconds()`** définit les millièmes de secondes pour la date, selon l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-setmilliseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-setmilliseconds.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setMilliseconds(valeurMs)
+ dateObj.setMilliseconds(valeurMs) -

Paramètres

+### Paramètres -
-
valeurMs
-
Un entier entre 0 et 999, représentant les millièmes de secondes.
-
+- `valeurMs` + - : Un entier entre 0 et 999, représentant les millièmes de secondes. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

Exemples

+## Exemples -

Utiliser setMilliseconds()

+### Utiliser `setMilliseconds()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setMilliseconds(100);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setMinutes() définit les minutes pour la date donnée, selon l'heure locale.

+La méthode **`setMinutes()`** définit les minutes pour la date donnée, selon l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-setminutes.html")}}
+{{EmbedInteractiveExample("pages/js/date-setminutes.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setMinutes(valeurMinutes[, valeurSecondes[, valeurMs]])
+ dateObj.setMinutes(valeurMinutes[, valeurSecondes[, valeurMs]]) -

Versions antérieures à JavaScript 1.3

+### Versions antérieures à JavaScript 1.3 -
dateObj.setMinutes(valeurMinutes)
+ dateObj.setMinutes(valeurMinutes) -

Paramètres

+### Paramètres -
-
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.
-
+- `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`. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setMinutes()

+### Utiliser `setMinutes()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setMinutes(45);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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")}}

+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")}} -
{{EmbedInteractiveExample("pages/js/date-setmonth.html")}}
+{{EmbedInteractiveExample("pages/js/date-setmonth.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setMonth(valeurMois[, valeurJour])
+ dateObj.setMonth(valeurMois[, valeurJour]) -

Versions antérieures à JavaScript 1.3

+### Versions antérieures à JavaScript 1.3 -
dateObj.setMonth(valeurMois)
+ dateObj.setMonth(valeurMois) -

Paramètres

+### Paramètres -
-
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.
-
+- `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. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

Si le paramètre valeurJour n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getDate", "getDate()")}} sera utilisée.

+Si le paramètre `valeurJour` n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getDate", "getDate()")}} sera utilisée. -

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.

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

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 :

+> **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 +> ``` -
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
-
+### Utiliser `setMonth()` -

Exemples

+```js +var leGrandJour = new Date(); +leGrandJour.setMonth(6); +``` -

Utiliser setMonth()

+## Spécifications -
var leGrandJour = new Date();
-leGrandJour.setMonth(6);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +| 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setSeconds() définit les secondes pour la date, selon l'heure locale.

+La méthode **`setSeconds()`** définit les secondes pour la date, selon l'heure locale. -
{{EmbedInteractiveExample("pages/js/date-setseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-setseconds.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setSeconds(valeurSecondes[, valeurMs])
+ dateObj.setSeconds(valeurSecondes[, valeurMs]) -

Versions antérieures à JavaScript 1.3

+### Versions antérieures à JavaScript 1.3 -
dateObj.setSeconds(valeurSecondes)
+ dateObj.setSeconds(valeurSecondes) -

Paramètres

+### Paramètres -
-
valeurSecondes
-
Un entier entre 0 et 59.
-
valeurMs
-
Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes.
-
+- `valeurSecondes` + - : Un entier entre 0 et 59. +- `valeurMs` + - : Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

Si le paramètre valeurMs n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} sera utilisée.

+Si le paramètre `valeurMs` n'est pas utilisé, la valeur renvoyée par la méthode {{jsxref("Date.getMilliseconds", "getMilliseconds()")}} sera utilisée. -

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.

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

Exemples

+## Exemples -

Utiliser setSeconds()

+### Utiliser `setSeconds()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setSeconds(30)
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-settime.html")}}
+{{EmbedInteractiveExample("pages/js/date-settime.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setTime(valeurTemps)
+ dateObj.setTime(valeurTemps) -

Paramètres

+### Paramètres -
-
valeurTemps
-
Un entier représentant le nombre de millisecondes depuis le 1 janvier 1970, 00:00:00 UTC.
-
+- `valeurTemps` + - : Un entier représentant le nombre de millisecondes depuis le 1 janvier 1970, 00:00:00 UTC. -

Valeur de retour

+### Valeur de retour -

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).

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

Description

+## Description -

La méthode setTime() est utilisée afin d'assigner une date à un autre objet {{jsxref("Date")}}.

+La méthode `setTime()` est utilisée afin d'assigner une date à un autre objet {{jsxref("Date")}}. -

Exemples

+## Exemples -

Utiliser setTime()

+### Utiliser `setTime()` -
var leGrandJour = new Date("July 1, 1999");
+```js
+var leGrandJour = new Date("July 1, 1999");
 var pareilQueGrandJour = new Date();
 pareilQueGrandJour.setTime(leGrandJour.getTime());
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setUTCDate() définit le jour du mois pour la date, selon UTC.

+La méthode **`setUTCDate()`** définit le jour du mois pour la date, selon UTC. -
{{EmbedInteractiveExample("pages/js/date-setutcdate.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutcdate.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCDate(valeurJour)
+ dateObj.setUTCDate(valeurJour) -

Paramètres

+### Paramètres -
-
valeurJour
-
Un entier de 1 à 31, représentant un jour dans le mois.
-
+- `valeurJour` + - : Un entier de 1 à 31, représentant un jour dans le mois. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

Exemples

+## Exemples -

Utiliser setUTCDate()

+### Utiliser `setUTCDate()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCDate(20);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setUTCFullYear() définit l'année complête pour la date, selon UTC.

+La méthode **`setUTCFullYear()`** définit l'année complête pour la date, selon UTC. -
{{EmbedInteractiveExample("pages/js/date-setutcfullyear.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutcfullyear.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCFullYear(valeurAnnée[, valeurMois[, valeurJour]])
+ dateObj.setUTCFullYear(valeurAnnée[, valeurMois[, valeurJour]]) -

Paramètres

+### Paramètres -
-
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.
-
+- `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`. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setUTCFullYear()

+### Utiliser `setUTCFullYear()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCFullYear(1997);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-setutchours.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutchours.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]])
+ dateObj.setUTCHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]]) -

Paramètres

+### Paramètres -
-
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.
-
+- `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. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setUTCHours()

+### Utiliser `setUTCHours()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCHours(8);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setUTCMilliseconds() définit les millièmes de secondes pour la date, selon UTC.

+La méthode **`setUTCMilliseconds()`** définit les millièmes de secondes pour la date, selon UTC. -
{{EmbedInteractiveExample("pages/js/date-setutcmilliseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutcmilliseconds.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCMilliseconds(valeurMs)
+ dateObj.setUTCMilliseconds(valeurMs) -

Paramètres

+### Paramètres -
-
valeurMs
-
Un entier entre 0 et 999, représentant les millièmes de secondes.
-
+- `valeurMs` + - : Un entier entre 0 et 999, représentant les millièmes de secondes. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

Exemples

+## Exemples -

Utiliser setUTCMilliseconds()

+### Utiliser `setUTCMilliseconds()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCMilliseconds(500);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setUTCMinutes() définit les minutes pour la date, selon UTC.

+La méthode **`setUTCMinutes()`** définit les minutes pour la date, selon UTC. -
{{EmbedInteractiveExample("pages/js/date-setutcminutes.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutcminutes.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCMinutes(valeurMinutes[, valeurSecondes[, valeurMs]])
+ dateObj.setUTCMinutes(valeurMinutes[, valeurSecondes[, valeurMs]]) -

Paramètres

+### Paramètres -
-
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.
-
+- `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`. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setUTCMinutes()

+### Utiliser `setUTCMinutes()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCMinutes(43);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setUTCMonth() définit le mois de la date, selon UTC.

+La méthode **`setUTCMonth()`** définit le mois de la date, selon UTC. -
{{EmbedInteractiveExample("pages/js/date-setutcmonth.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutcmonth.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCMonth(valeurMois[, valeurJour])
+ dateObj.setUTCMonth(valeurMois[, valeurJour]) -

Paramètres

+### Paramètres -
-
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.
-
+- `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. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setUTCMonth()

+### Utiliser `setUTCMonth()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCMonth(11);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode setUTCSeconds() définit les secondes pour la date, selon UTC.

+La méthode **`setUTCSeconds()`** définit les secondes pour la date, selon UTC. -
{{EmbedInteractiveExample("pages/js/date-setutcseconds.html")}}
+{{EmbedInteractiveExample("pages/js/date-setutcseconds.html")}} -

Syntaxe

+## Syntaxe -
dateObj.setUTCSeconds(valeurSecondes[, valeurMs])
+ dateObj.setUTCSeconds(valeurSecondes[, valeurMs]) -

Paramètres

+### Paramètres -
-
valeurSecondes
-
Un entier entre 0 et 59.
-
valeurMs
-
Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes.
-
+- `valeurSecondes` + - : Un entier entre 0 et 59. +- `valeurMs` + - : Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

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.

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

Exemples

+## Exemples -

Utiliser setUTCSeconds()

+### Utiliser `setUTCSeconds()` -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 leGrandJour.setUTCSeconds(20);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}} {{deprecated_header}}
+{{JSRef}} {{deprecated_header}} -

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")}}.

+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")}}. -

Syntaxe

+## Syntaxe -
dateObj.setYear(valeurAnnée)
+ dateObj.setYear(valeurAnnée) -

Paramètres

+### Paramètres -
-
valeurAnnée
-
Un entier.
-
+- `valeurAnnée` + - : Un entier. -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

+Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour. -

Description

+## Description -

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.

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

Exemples

+## Exemples -

Utiliser setYear()

+### Utiliser `setYear()` -

Les deux premières instructions définissent l'année 1996. La troisième définit l'année 2000.

+Les deux premières instructions définissent l'année 1996. La troisième définit l'année 2000. -
var leGrandJour = new Date();
+```js
+var leGrandJour = new Date();
 
 leGrandJour.setYear(96);
 leGrandJour.setYear(1996);
 leGrandJour.setYear(2000);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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 :

+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 : -
    -
  1. Les trois premières lettre indiquent le jour
    2. -
  2. Les trois lettres suivantes indiquent le mois
    3. -
  3. Les deux chiffres suivants indiquent le jour du mois (et sont complétés avec un 0 devant si besoin)
    4. -
  4. Les quatre chiffres restants indiquent l'année (si besoin complétées avec des 0 comme préfixe)
    5. -
+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) -
{{EmbedInteractiveExample("pages/js/date-todatestring.html")}}
+{{EmbedInteractiveExample("pages/js/date-todatestring.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères qui représente la date indiquée, dans un format anglais américain.

+Une chaîne de caractères qui représente la date indiquée, dans un format anglais américain. -

Description

+## Description -

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, 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().

+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()`. -

La méthode toDateString() est particulièrement utile car, pour les moteurs implémentant fidèlement ECMA-262, 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.

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

Exemples

+## Exemples -

Utiliser simplement toDateString()

+### Utiliser simplement `toDateString()` -
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
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +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 --- -
{{JSRef}} {{deprecated_header}}
+{{JSRef}} {{deprecated_header}} -

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.

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

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.

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

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant la date indiquée selon la convention internet pour GMT (Greenwich Mean Time).

+Une chaîne de caractères représentant la date indiquée selon la convention internet pour GMT (_Greenwich Mean Time_). -

Exemples

+## Exemples -

Utiliser toGMTString()

+### Utiliser `toGMTString()` -

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.

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

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode toISOString() renvoie une chaîne de caractères au format ISO (ISO 8601 Extended Format), 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).

+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). -
{{EmbedInteractiveExample("pages/js/date-toisostring.html")}}
+{{EmbedInteractiveExample("pages/js/date-toisostring.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant la date indiquée au format ISO 8601 selon le temps universel.

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

Exemples

+## Exemples -

Utiliser toISOString()

+### Utiliser `toISOString()` -
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"
-
+``` -

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.

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

Prothèse d'émulation (polyfill)

+## Prothèse d'émulation (_polyfill_) -

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 :

+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 : -
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"
     };
 
   }() );
-}
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +} +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode toJSON() renvoie une chaîne représentant l'objet {{jsxref("Date")}} sous forme {{Glossary("JSON")}}

+La méthode **`toJSON()`** renvoie une chaîne représentant l'objet {{jsxref("Date")}} sous forme {{Glossary("JSON")}} -
{{EmbedInteractiveExample("pages/js/date-tojson.html")}}
+{{EmbedInteractiveExample("pages/js/date-tojson.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant la date indiquée.

+Une chaîne de caractères représentant la date indiquée. -

Description

+## Description -

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.

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

Exemple

+## Exemple -

Utiliser toJSON()

+### Utiliser `toJSON()` -
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
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}}
+{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}} -

Syntaxe

+## Syntaxe -
dateObj.toLocaleDateString([locales [, options]])
+ dateObj.toLocaleDateString([locales [, options]]) -

Paramètres

+### Paramètres -

Voir le tableau de compatibilité 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 qui permet de détecter cette fonctionnalité.

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

{{page('fr/docs/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}}

+{{page('fr/docs/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}} -

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 ».

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères qui représente le jour de la date indiquée selon des options de locales.

+Une chaîne de caractères qui représente le jour de la date indiquée selon des options de locales. -

Exemples

+## Exemples -

Utiliser toLocaleDateString()

+### Utiliser `toLocaleDateString()` -

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.

+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. -
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
+// → "12/12/2012" si exécuté dans une locale fr et le fuseau horaire CEST +``` -

Vérifier le support des arguments locales et options

+### Vérifier le support des arguments `locales` et `options` -

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 :

+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` : -
function toLocaleDateStringSupportsLocales() {
+```js
+function toLocaleDateStringSupportsLocales() {
     try {
         new Date().toLocaleDateString("i");
     } catch (e) {
@@ -60,13 +63,14 @@ date.toLocaleDateString();
     }
     return false;
 }
-
+``` -

Utiliser l'argument locales

+### Utiliser l'argument `locales` -

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 :

+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` : -
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"));
-// → "٢٠‏/١٢‏/٢٠١٢"
+// → "٢٠‏/١٢‏/٢٠١٢"
 
 // 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"
-
+``` -

Utiliser l'argument options

+### Utiliser l'argument `options` -

Les résultats fournis par toLocaleDateString() peuvent être personnalisés grâce à l'argument options :

+Les résultats fournis par `toLocaleDateString()` peuvent être personnalisés grâce à l'argument `options` : -
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"
-
- -

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ÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-tolocalestring.html")}}
+{{EmbedInteractiveExample("pages/js/date-tolocalestring.html")}} -

Syntaxe

+## Syntaxe -
dateObj.toLocaleString([locales [, options]])
+ dateObj.toLocaleString([locales [, options]]) -

Paramètres

+### Paramètres -

Voir le tableau de compatibilité 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 qui permet de détecter cette fonctionnalité.

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

{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}}

+{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Paramètres')}} -

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".

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant la date indiquée selon des conventions de locales spécifiques.

+Une chaîne de caractères représentant la date indiquée selon des conventions de locales spécifiques. -

Exemples

+## Exemples -

Utiliser toLocaleString()

+### Utiliser `toLocaleString()` -

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.

+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. -
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
+// → "21/12/2014 04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST +``` -

Vérifier le support des arguments locales et options

+### Vérifier le support des arguments `locales` et `options` -

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")}} :

+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")}} : -
function toLocaleStringSupportsLocales() {
+```js
+function toLocaleStringSupportsLocales() {
     try {
         new Date().toLocaleString("i");
     } catch (e) {
@@ -60,13 +63,14 @@ date.toLocaleString();
     }
     return false;
 }
-
+``` -

Utiliser locales

+### Utiliser `locales` -

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 :

+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` : -
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"
-
+``` -

Utiliser options

+### Utiliser `options` -

Les résultats fournis par toLocaleString() peuvent être personnalisés grâce à l'argument options :

+Les résultats fournis par `toLocaleString()` peuvent être personnalisés grâce à l'argument `options` : -
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"
-
+``` -

Comparaison des dates formatées et des valeurs statiques

+### Comparaison des dates formatées et des valeurs statiques -

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.

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

Aussi, mieux vaut ne pas comparer un résultat fourni par format() avec une valeur statique :

+Aussi, mieux vaut ne pas comparer un résultat fourni par `format()` avec une valeur statique : -
"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
-
- -
-

Note : Voir aussi ce fil StackOverflow 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ÉtatCommentaires
{{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

- - +``` + +> **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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-tolocaletimestring.html")}}
+{{EmbedInteractiveExample("pages/js/date-tolocaletimestring.html")}} -

Syntaxe

+## Syntaxe -
dateObj.toLocaleTimeString([locales [, options]])
+ dateObj.toLocaleTimeString([locales [, options]]) -

Paramètres

+### Paramètres -

Voir le tableau de compatibilité 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 qui permet de détecter cette fonctionnalité.

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

{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Param.C3.A8tres')}}

+{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Param.C3.A8tres')}} -

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".

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères qui représente l'heure de la date indiquée selon des conventions de locales spécifiques.

+Une chaîne de caractères qui représente l'heure de la date indiquée selon des conventions de locales spécifiques. -

Exemples

+## Exemples -

Utiliser toLocaleTimeString()

+### Utiliser `toLocaleTimeString()` -

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.

+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. -
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
+// → "04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST +``` -

Vérifier le support des arguments locales et options

+### Vérifier le support des arguments `locales` et `options` -

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 :

+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` : -
function toLocaleTimeStringSupportsLocales() {
+```js
+function toLocaleTimeStringSupportsLocales() {
     try {
         new Date().toLocaleTimeString("i");
     } catch (e) {
@@ -60,13 +63,14 @@ console.log(date.toLocaleTimeString());
     }
     return false;
 }
-
+``` -

Utiliser locales

+### Utiliser `locales` -

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 :

+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` : -
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"
-
+``` -

Utiliser options

+### Utiliser `options` -

Les résultats fournis par toLocaleTimeString() peuvent être personnalisés grâce à l'argument options :

+Les résultats fournis par `toLocaleTimeString()` peuvent être personnalisés grâce à l'argument `options` : -
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"
-
- -

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ÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}} {{Non-standard_header}}
+{{JSRef}} {{Non-standard_header}} -

La méthode toSource() renvoie une chaîne de caractères représentant le code source de l'objet.

+La méthode **`toSource()`** renvoie une chaîne de caractères représentant le code source de l'objet. -

Syntaxe

+## Syntaxe -
dateObj.toSource()
-Date.toSource()
+ dateObj.toSource() + Date.toSource() -

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant le code source de l'objet date indiqué.

+Une chaîne de caractères représentant le code source de l'objet date indiqué. -

Description

+## Description -

La méthode toSource() renvoie les valeur suivantes :

+La méthode `toSource()` renvoie les valeur suivantes : - +- Pour l'objet natif {{jsxref("Date")}}, `toSource()` renvoie la chaîne de caractères suivante, indiquant que le code source n'est pas disponible : -
function Date() {
+```js
+function Date() {
     [native code]
-}
+} +``` - +- Pour les instances de {{jsxref("Date")}}, `toSource()` renvoie une chaîne de caractères représentant le code source. -

Cette méthode est habituellement appelée en interne par le moteur JavaScript et non explicitement dans le code d'un script.

+Cette méthode est habituellement appelée en interne par le moteur JavaScript et non explicitement dans le code d'un script. -

Spécifications

+## Spécifications -

Ne fait partie d'aucune spécification. Implémentée dans JavaScript 1.3.

+Ne fait partie d'aucune spécification. Implémentée dans JavaScript 1.3. -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

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

+{{Compat("javascript.builtins.Date.toSource")}} -

Voir aussi

+## Voir aussi - +- {{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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode toString() renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}}.

+La méthode **`toString()`** renvoie une chaîne de caractères représentant l'objet {{jsxref("Date")}}. -
{{EmbedInteractiveExample("pages/js/date-tostring.html")}}
+{{EmbedInteractiveExample("pages/js/date-tostring.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant la date indiquée.

+Une chaîne de caractères représentant la date indiquée. -

Description

+## Description -

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.

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

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 :

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

Avant ES2018, le format de la chaîne de caractères renvoyé pouvait varier selon l'implémentation.

+ - La chaîne "+" pour les décalages positifs (0 ou plus) + - La chaîne "-" pour les décalages strictement négatifs -

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.

+- L'heure de décalage sur deux chiffres +- Les minutes de décalage sur deux chiffres +- Et, éventuellement, le nom du fuseau horaire avec -

toString() est une méthode générique. Si this n'est pas une instance de {{jsxref("Date")}}, elle renverra "Invalid Date".

+ - 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 (« ) ») -

Exemples

+Avant ES2018, le format de la chaîne de caractères renvoyé pouvait varier selon l'implémentation. -

Utiliser toString()

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

L'exemple suivant assigne la valeur de toString() de l'objet Date à maVar :

+`toString()` est une méthode générique. Si `this` n'est pas une instance de {{jsxref("Date")}}, elle renverra "Invalid Date". -
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)
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode toTimeString()renvoie la partie « heure » de l'objet Date dans un format lisible par un humain, en anglais américain.

+La méthode **`toTimeString()`**renvoie la partie « heure » de l'objet `Date` dans un format lisible par un humain, en anglais américain. -
{{EmbedInteractiveExample("pages/js/date-totimestring.html")}}
+{{EmbedInteractiveExample("pages/js/date-totimestring.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères qui représente l'heure de la date indiquée dans un format anglais américain.

+Une chaîne de caractères qui représente l'heure de la date indiquée dans un format anglais américain. -

Description

+## Description -

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, 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().

+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().` -

La méthode toTimeString() est particulièrement utile parce que les moteurs implémentant ECMA-262 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.

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

Exemple

+## Exemple -

Utiliser toTimeString()

+### Utiliser `toTimeString()` -
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)
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode toUTCString() convertit une date en une chaîne de caractères, selon le fuseau horaire UTC.

+La méthode **`toUTCString()`** convertit une date en une chaîne de caractères, selon le fuseau horaire UTC. -
{{EmbedInteractiveExample("pages/js/date-toutcstring.html")}}
+{{EmbedInteractiveExample("pages/js/date-toutcstring.html")}} -

Syntaxe

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

Valeur de retour

+### Valeur de retour -

Une chaîne de caractères représentant la date indiquée selon le fuseau horaire UTC.

+Une chaîne de caractères représentant la date indiquée selon le fuseau horaire UTC. -

Description

+## Description -

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).

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

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.

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

Exemples

+## Exemples -

Utiliser toUTCString()

+### Utiliser `toUTCString()` -
var aujourdhui = new Date();
+```js
+var aujourdhui = new Date();
 var UTCstring = aujourdhui.toUTCString();
 // Mon, 03 Jul 2006 21:44:38 GMT
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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 --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/date-utc.html")}}
+{{EmbedInteractiveExample("pages/js/date-utc.html")}} -

Syntaxe

+## Syntaxe -
Date.UTC(année[,mois[,jour[,heures[,minutes[,secondes[,ms]]]]]])
+ Date.UTC(année[,mois[,jour[,heures[,minutes[,secondes[,ms]]]]]]) -

Paramètres

+## Paramètres -
-
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}}
-
-

Un entier entre 0 (janvier) et 11 (décembre) représentant le mois.

+- `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}} -

Note : Cet argument est optionnel depuis ECMAScript 2017.

-
-
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.
-
+ - : Un entier entre 0 (janvier) et 11 (décembre) représentant le mois. -

Valeur de retour

+ > **Note :** Cet argument est optionnel depuis ECMAScript 2017. -

Un nombre représentant le nombre de millisecondes écoulées entre la date indiquée et le premier janvier 1970 à minuit UTC.

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

Description

+### Valeur de retour -

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.

+Un nombre représentant le nombre de millisecondes écoulées entre la date indiquée et le premier janvier 1970 à minuit UTC. -

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.

+## Description -

La méthode UTC diffère du constructeur {{jsxref("Date")}} pour deux raisons :

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

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.

+La méthode `UTC` diffère du constructeur {{jsxref("Date")}} pour deux raisons : -

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éé.

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

Exemples

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

Utiliser Date.UTC()

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

L'instruction qui suit crée un objet Date en utilisant l'heure UTC plutôt que l'heure locale :

+## Exemples -
var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
-
+### Utiliser `Date.UTC()` -

Spécifications

+L'instruction qui suit crée un objet `Date` en utilisant l'heure UTC plutôt que l'heure locale : - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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.
+```js +var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0)); +``` -

Compatibilité des navigateurs

+## Spécifications -

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

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

Notes de compatibilité

+## Compatibilité des navigateurs -

Utiliser Date.UTC avec moins de deux arguments

+{{Compat("javascript.builtins.Date.UTC")}} -

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).

+## Notes de compatibilité -
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
-
+``` -

Voir aussi

+## Voir aussi - +- {{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 --- -
{{JSRef}}
+{{JSRef}} -

La méthode valueOf() renvoie la valeur primitive d'un objet {{jsxref("Date")}}.

+La méthode **`valueOf()`** renvoie la valeur primitive d'un objet {{jsxref("Date")}}. -
{{EmbedInteractiveExample("pages/js/date-valueof.html")}}
+{{EmbedInteractiveExample("pages/js/date-valueof.html")}} -

Syntaxe

+## Syntaxe -
date.valueOf()
+ date.valueOf() -

Valeur de retour

+### Valeur de retour -

Le nombre de millisecondes écoulées entre le premier janvier 1970, minuit UTC et la date indiquée.

+Le nombre de millisecondes écoulées entre le premier janvier 1970, minuit UTC et la date indiquée. -

Description

+## Description -

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.

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

D'un point de vue fonctionnel, cette méthode est équivalente à {{jsxref("Date.prototype.getTime()")}}.

+D'un point de vue fonctionnel, cette méthode est équivalente à {{jsxref("Date.prototype.getTime()")}}. -

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.

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

Exemples

+## Exemples -

Utiliser valueOf()

+### Utiliser `valueOf()` -
var x = new Date(56, 6, 17);
+```js
+var x = new Date(56, 6, 17);
 var maVar = x.valueOf();      // maVar vaut -424713600000
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{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

- - +``` + +## 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()")}} -- cgit v1.2.3-54-g00ecf