Date : méthode statique UTC() - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Date : méthode statique UTC()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode statique Date.UTC() accepte des paramètres représentant les composantes de date et d'heure, comme le constructeur Date, mais les considère comme UTC. Elle retourne le nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.

Dans cet article

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());
// Résultat attendu : "Fri, 02 Feb 1996 03:04:05 GMT"

console.log(utcDate2.toUTCString());
// Résultat attendu : "Sun, 31 Dec 1899 00:00:00 GMT"

Syntaxe

js
Date.UTC(year)
Date.UTC(year, monthIndex)
Date.UTC(year, monthIndex, day)
Date.UTC(year, monthIndex, day, hours)
Date.UTC(year, monthIndex, day, hours, minutes)
Date.UTC(year, monthIndex, day, hours, minutes, seconds)
Date.UTC(year, monthIndex, day, hours, minutes, seconds, milliseconds)

Paramètres

year

Valeur entière représentant l'année. Les valeurs de 0 à 99 correspondent aux années de 1900 à 1999. Toutes les autres valeurs correspondent à l'année réelle. Voir l'exemple.

monthIndex Facultatif

Valeur entière représentant le mois, commençant à 0 pour janvier jusqu'à 11 pour décembre. La valeur par défaut est 0.

day Facultatif

Valeur entière représentant le jour du mois. La valeur par défaut est 1.

hours Facultatif

Valeur entière comprise entre 0 et 23 représentant l'heure du jour. La valeur par défaut est 0.

minutes Facultatif

Valeur entière représentant les minutes. La valeur par défaut est 0.

seconds Facultatif

Valeur entière représentant les secondes. La valeur par défaut est 0.

milliseconds Facultatif

Valeur entière représentant les millisecondes. La valeur par défaut est 0.

Valeur de retour

Un nombre représentant le timestamp de la date donnée. Retourne NaN si la date est invalide.

Description

Les années comprises entre 0 et 99 sont converties en une année du 20e siècle (1900 + year). Par exemple, 95 est converti en l'année 1995.

La méthode UTC() diffère du constructeur Date() de trois façons :

Date.UTC() utilise le temps universel plutôt que l'heure locale.
Date.UTC() retourne une valeur temporelle sous la forme d'un nombre au lieu de créer un objet Date.
Lorsqu'un seul nombre est passé, Date.UTC() l'interprète comme une année et non comme un timestamp.

Si un paramètre est en dehors de la plage attendue, la méthode UTC() ajuste les autres paramètres pour s'adapter à la valeur. Par exemple, si 15 est utilisé pour monthIndex, l'année sera incrémentée de 1 (year + 1) et 3 sera utilisé pour le mois.

Comme UTC() est une méthode statique de Date, vous l'utilisez toujours sous la forme Date.UTC(), et non comme une méthode d'un objet Date que vous auriez créé.

Exemples

Utiliser la méthode Date.UTC()

L'instruction suivante crée un objet Date avec les arguments considérés comme UTC plutôt que locaux :

const utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

Comportement de Date.UTC() avec un seul argument

Date.UTC() lorsqu'elle reçoit un seul argument avait un comportement incohérent, car les implémentations ne gardaient la cohérence qu'avec le constructeur Date(), qui n'interprète pas un seul argument comme une année. Les implémentations doivent maintenant traiter un monthIndex omis comme 0, au lieu de le contraindre à NaN.

Date.UTC(2017); // 1483228800000

La méthode statique Date.parse()
L'objet Date

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 27 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Date
Constructeur
1. Date()
Méthodes statiques
1. now()
2. parse()
3. UTC()
Méthodes d'instance
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor