La méthode Date.UTC() accepte les mêmes paramètres que la forme la plus longue du constructeur 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.

Syntaxe

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

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
Un entier entre 0 (janvier) et 11 (décembre) représentant le mois.
jourFacultatif
Un entier entre 1 et 31 représentant le jour du mois. La valeur par défaut vaut 1.
heuresFacultatif
Paramètre optionnel, un entier entre 0 et 23 représentant les heures. La valeur par défaut vaut 0.
minutesFacultatif
Paramètre optionnel, un entier entre 0 et 59 représentant les minutes. La valeur par défaut vaut 0.
secondesFacultatif
Paramètre optionnel, un entier entre 0 et 59 représentant les secondes. La valeur par défaut vaut 0.
msFacultatif
Paramètre optionnel, un entier entre 0 et 999 représentant les millièmes de seconde. La valeur par défaut vaut 0.

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

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 Latest 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

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet

Notes de compatibilité

Utiliser Date.UTC avec moins de deux arguments

Lorsqu'on fournit moins de deux arguments à Date.UTC, 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).

Date.UTC();
Date.UTC(1);

// Safari: NaN 
// Chrome/Opera/V8: NaN

// Firefox <54: non-NaN
// Firefox 54+: NaN

// IE: non-NaN
// Edge: NaN

Voir aussi

Étiquettes et contributeurs liés au document

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