Date.UTC()

La méthode Date.UTC() 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.

Syntaxe

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

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
Paramètre optionnel, un entier entre 1 et 31 représentant le jour du mois.
heures
Paramètre optionnel, un entier entre 0 et 23 représentant les heures.
minutes
Paramètre optionnel, un entier entre 0 et 59 représentant les minutes.
secondes
Paramètre optionnel, un entier entre 0 et 59 représentant les secondes.
ms
Paramètre optionnel, un entier entre 0 et 999 représentant les millièmes de seconde.

Valeur de retour

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

Description

La méthode 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.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.

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

Exemples

Utiliser Date.UTC()

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

var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));

Spécifications

Spécification État Commentaires
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Date.UTC' dans cette spécification.
Projet  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.UTC' dans cette spécification.
Standard  
ECMAScript 5.1 (ECMA-262)
La définition de 'Date.UTC' dans cette spécification.
Standard  
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple ? ? ? ? ? ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, tregagnon, Jeremie, Mgjbot, BenoitL
 Dernière mise à jour par : SphinxKnight,