Référence de JavaScript 1.5 Core:Objets globaux:Date:UTC
Un article de MDC.
Sommaire |
[modifier] Résumé
Accepte les mêmes paramètres que la forme la plus longue du constructeur, et renvoie le nombre de millièmes de seconde dans un objet Date depuis le 1er janvier 1970, 00:00:00, temps universel.
| Méthode de Date | |
| Statique | |
| Implémentation : | JavaScript 1.0, NES 2.0
JavaScript 1.3 : ajout du paramètre |
| Version ECMA : | ECMA-262 |
[modifier] Syntaxe
Date.UTC(année, mois[, jour[, heures[, minutes[, secondes[, ms]]]]]);
[modifier] Paramètres
-
année - Une année après 1900.
-
mois - Un entier entre 0 (janvier) et 11 (décembre) représentant le mois.
-
jour - Un entier entre 1 et 31 représentant le jour du mois.
-
heures - Un entier entre 0 et 23 représentant les heures.
-
minutes - Un entier entre 0 et 59 représentant les minutes.
-
secondes - Un entier entre 0 et 59 représentant les secondes.
-
ms - Un entier entre 0 et 999 représentant les millièmes de seconde.
[modifier] Description
UTC prend des paramètres de date 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.
La méthode UTC diffère du constructeur Date pour deux raisons.
-
Date.UTCutilise le temps universel plutôt que l'heure locale. -
Date.UTCrenvoie une valeur temporelle sous la forme d'un nombre plutôt que de créer un objetDate.
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.
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éé.
[modifier] Exemples
[modifier] Exemple : utilisation de Date.UTC
L'instruction qui suit crée un objet Date en utilisant l'heure UTC (anciennement GMT) plutôt que l'heure locale :
gmtDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));