La méthodeDate.UTC() accepte des paramètres similaires à ceux du constructeurDate 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.

Exemple interactif

const utcDate1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));const utcDate2 = new Date(Date.UTC(0, 0, 0, 0, 0, 0));console.log(utcDate1.toUTCString());// Expected output: "Fri, 02 Feb 1996 03:04:05 GMT"console.log(utcDate2.toUTCString());// Expected output: "Sun, 31 Dec 1899 00:00:00 GMT"

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

moisFacultatif

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

Note :Cet argument est optionnel depuis ECMAScript 2017.

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éthodeUTC 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éthodeUTC diffère du constructeurDate 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 objetDate.

Si un paramètre spécifié est en dehors des limites attendues, la méthodeUTC 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.

CommeUTC est une méthode statique deDate, on l'utilise toujours sous la formeDate.UTC() plutôt que comme une méthode d'un objetDate que vous auriez créé.

Exemples

UtiliserDate.UTC()

L'instruction qui suit crée un objetDate 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

Compatibilité des navigateurs

Voir aussi

• Date.parse()