Heure du rendez-vous

JavaScript possède un objet intégré Date qui stocke la date et l'heure, et fournit des méthodes pour les gérer.

Création

Un objet Date est une instance de la classe Date. Il peut être créé sans passer d'arguments à la fonction constructeur. Le résultat est un objet Date qui représente la date et l'heure actuelles :

const now = new Date();
// => Thu Apr 14 2022 11:46:08 GMT+0530 (India Standard Time)
// Shows current day, date and time (in your time zone).

Horodatage Unix (nombre)

Si un nombre est passé, il sera interprété comme un timestamp. Un horodatage est un nombre entier qui représente le nombre de millisecondes écoulées depuis le 1er janvier 1970 UTC+0.

const epoch = new Date(0);
// Thu Jan 01 1970 01:00:00 GMT+0100 (Central European Standard Time)

const another = new Date(1749508766627);
// Tue Jun 10 2025 00:39:26 GMT+0200 (Central European Summer Time)

On pourrait s'attendre à ce que new Date(0) génère l'objet date « le plus ancien », mais JavaScript convertit la date dans ton fuseau horaire local, ce qui signifie que seules les personnes situées dans un fuseau GMT / UTC+0 obtiendront réellement la valeur de l'époque Unix.

Horodatage ISO 8601 (string)

Tu peux passer une string représentant une date au constructeur Date. Le seul format cohérent d'une implémentation à l'autre est la version simplifiée des fameuses chaînes d'horodatage ISO 8601, reconnues et normalisées au niveau international.

Un instant en UTC ressemble à ceci :

YYYY-MM-DDTHH:mm:ss.mssZ
YYYYMMDDTHHmmss.mssZ

où les substitutions suivantes ont lieu :

La lettre littérale Z indique UTC (aucun fuseau horaire, pas d'heure d'été).

Comme la plupart des composants ont des valeurs par défaut, on peut valablement omettre des parties à la fin :

YYYY-MM-DD

La valeur par défaut est l'heure 00:00:00.000

Si l'horodatage ne se termine pas par Z, et ne se termine ni par +HH:mm ni par -HH:mm (ce qui indique un décalage de fuseau horaire), alors, pour des raisons historiques, ce qui suit s'applique :

Lorsque le décalage de fuseau horaire est absent, les formes contenant uniquement une date sont interprétées comme une heure UTC et les formes contenant une date et une heure sont interprétées comme une heure locale. L'interprétation comme heure UTC est due à une erreur historique de la spécification, qui n'était pas cohérente avec la norme ISO 8601 mais qui n'a pas pu être corrigée pour des raisons de compatibilité web. Voir Analyseur cassé : un problème de réalité du Web.

Objet Date

Un objet date existant peut aussi être utilisé comme argument du constructeur. Cela crée une copie de l'objet Date existant, avec la même date et la même heure.

const t1 = new Date();
const t2 = new Date(t1);
// Values of t1 and t2 will be the same.

Fournis les valeurs individuelles des composants de date et d'heure

Un objet date représentant une date peut être créé en passant trois nombres. Un objet date représentant une date et une heure peut être créé en passant 6 nombres.

const date1 = new Date(95, 11, 17);
// Creates Date for Dec 17 1995 00:00 if your local timezone is equivalent to UTC.

const date2 = new Date(2013, 12, 5, 13, 24, 0);
// Creates Date for Jan 5 2014 13:24 if your local timezone is equivalent to UTC.

La deuxième valeur est le month, qui commence à 0 pour janvier et va jusqu'à 11 pour décembre.

Date.parse()

Tu peux trouver des mentions ou des références à une fonction d'analyse de dates, Date.parse. Comme cette fonction ne comporte que peu d'invariants (de vérités) et que le reste de son implémentation n'est pas spécifié (et donc non standard), il ne faut pas l'utiliser.

Accède aux composants de Date

Il existe diverses méthodes sur les objets date qui renvoient les composants de la date :

getFullYear(); // Get the year (4 digits)
getMonth(); // Get the month, from 0 to 11.
getDate(); // Get the day of month, from 1 to 31.
getHours(); // Get the hour in a 24 clock, from 0 to 23
getMinutes(); // Get the minutes, from 0 to 59
getSeconds(); // Get the seconds, from 0 to 59
getMilliseconds(); // Get the milliseconds, from 0 and 999
getDay(); // Get the day of week, from 0 (Sunday) to 6 (Saturday).

Chacune d'elles possède une variante set correspondante (par exemple setFullYear) pour mettre à jour la valeur. Toute valeur en dépassement se reporte sur le composant suivant :

const date = new Date('2025-02-28T12:42:00Z');
// => Fri Feb 28 2025 13:42:00 GMT+0100 (Central European Standard Time)

date.setDate(29);
// there was no February 29th in 2025.

date.getDate();
// => 1

date.toString();
// => Sat Mar 01 2025 13:42:00 GMT+0100 (Central European Standard Time)

Il existe des variantes UTC de toutes les méthodes qui ignorent le fuseau horaire local.

Convertis à partir d'une date

Les objets date possèdent une méthode getTime() qui renvoie l'horodatage UNIX en millisecondes, c'est-à-dire le nombre de millisecondes écoulées depuis minuit au début du 1er janvier 1970, UTC. De plus, une méthode toISOString() permet de convertir un objet date en une string d'horodatage ISO 8601.

Compare les dates

Les opérateurs « supérieur à » (>) et « supérieur ou égal à » (>=), ainsi que « inférieur à » (<) et « inférieur ou égal à » (<=), peuvent être utilisés directement entre deux dates, ou entre une date et un nombre. Cela fonctionne parce que JavaScript essaie de convertir la date en une valeur primitive.

Les dates ne peuvent pas être comparées avec les opérateurs d'égalité (== et ===), mais le résultat de .getTime() peut l'être.