Dates JavaScript


Les objets Date en JavaScript nous permettent de travailler avec des dates :

Exemples

const d = new Date();
Essayez-le vous-même »
const d = new Date("2022-03-25");
Essayez-le vous-même »

Remarque

Les objets Date sont statiques. L'« horloge » n'est pas « en marche ».

L'horloge de l'ordinateur tourne, mais les objets Date ne le font pas.


Sortie de Date JavaScript

Par défaut, JavaScript utilisera le fuseau horaire du navigateur et affichera une date sous forme de chaîne de texte complète :

Vous apprendrez beaucoup plus sur la façon d'afficher des dates plus tard dans ce tutoriel.


Création d'objets Date

Les objets Date sont créés avec le new Date() constructeur.

Il existe 9 façons de créer un nouvel objet date :

new Date()
new Date( chaîne de date )

new Date( année,mois )
new Date( année,mois,jour )
new Date( année,mois,jour,heures )
new Date( année,mois,jour,heures,minutes )
new Date( année,mois,jour,heures,minutes,secondes )
new Date( année,mois,jour,heures,minutes,secondes,ms )

new Date( millisecondes )

JavaScript new Date()

new Date() crée un objet date avec la date et l'heure actuelles :

Exemple

const d = new Date();
Essayez-le vous-même »

new Date( chaîne de date )

new Date( chaîne de date ) crée un objet date à partir d'une chaîne de date :

Exemples

const d = new Date("13 octobre 2014 11:13:00");
Essayez-le vous-même »
const d = new Date("2022-03-25");
Essayez-le vous-même »

Les formats de chaîne de date sont décrits dans le chapitre suivant.


new Date( année, mois, ... )

new Date( année, mois, ... ) crée un objet date avec une date et heure spécifiées .

7 nombres spécifient l'année, le mois, le jour, l'heure, la minute, la seconde et la milliseconde (dans cet ordre) :

Exemple

const d = new Date(2018, 11, 24, 10, 33, 30, 0);
Essayez-le vous-même »

Remarque

JavaScript compte les mois de 0 à 11 :

Janvier = 0 .

Décembre = 11 .

Spécifier un mois supérieur à 11 ne générera pas d'erreur, mais ajoutera le débordement à l'année suivante :

Spécifiant :

const d = new Date(2018, 15, 24, 10, 33, 30);
Essayez-le vous-même »

Cela équivaut à :

const d = new Date(2019, 3, 24, 10, 33, 30);
Essayez-le vous-même »

Spécifier un jour supérieur au maximum ne générera pas d'erreur, mais ajoutera le débordement au mois suivant :

Spécifiant :

const d = new Date(2018, 5, 35, 10, 33, 30);

Cela équivaut à :

const d = new Date(2018, 6, 5, 10, 33, 30);
Essayez-le vous-même »

Utilisation de 6, 4, 3 ou 2 Nombres

6 nombres spécifient l'année, le mois, le jour, l'heure, la minute et la seconde :

Exemple

const d = new Date(2018, 11, 24, 10, 33, 30);
Essayez-le vous-même »

5 nombres spécifient l'année, le mois, le jour, l'heure et la minute :

Exemple

const d = new Date(2018, 11, 24, 10, 33);
Essayez-le vous-même »

4 nombres spécifient l'année, le mois, le jour et l'heure :

Exemple

const d = new Date(2018, 11, 24, 10);
Essayez-le vous-même »

3 nombres spécifient l'année, le mois et le jour :

Exemple

const d = new Date(2018, 11, 24);
Essayez-le vous-même »

2 nombres spécifient l'année et le mois :

Exemple

const d = new Date(2018, 11);
Essayez-le vous-même »

Vous ne pouvez pas omettre le mois. Si vous ne fournissez qu'un seul paramètre, il sera traité comme des millisecondes.

Exemple

const d = new Date(2018);
Essayez-le vous-même »

Siècle Précédent

Les années à un et deux chiffres seront interprétées comme 19xx :

Exemple

const d = new Date(99, 11, 24);
Essayez-le vous-même »

Exemple

const d = new Date(9, 11, 24);
Essayez-le vous-même »

JavaScript Stocke les Dates en Millisecondes

JavaScript stocke les dates comme le nombre de millisecondes depuis le 1er janvier 1970.

Le temps zéro est le 1er janvier 1970 00:00:00 UTC .

Un jour (24 heures) équivaut à 86 400 000 millisecondes.

Actuellement, le temps est : millisecondes après le 1er janvier 1970.


new Date( millisecondes )

new Date( millisecondes ) crée un nouvel objet date à partir de millisecondes ajoutées au temps zéro :

Exemples

01 janvier 1970 plus 100 000 000 000 millisecondes est :

const d = new Date(100000000000);
Essayez-le vous-même »

01 janvier 1970 moins 100 000 000 000 millisecondes est :

const d = new Date(-100000000000);
Essayez-le vous-même »

01 janvier 1970 plus 24 heures est :

const d = new Date(24 * 60 * 60 * 1000);
// ou
const d = new Date(86400000);
Essayez-le vous-même »

01 janvier 1970 plus 0 millisecondes est :

const d = new Date(0);
Essayez-le vous-même »


Méthodes de Date

Lorsqu'un objet date est créé, un certain nombre de méthodes vous permettent d'opérer dessus.

Les méthodes de date vous permettent d'obtenir et de définir l'année, le mois, le jour, l'heure, la minute, la seconde et la milliseconde des objets date, en utilisant soit l'heure locale, soit l'heure UTC (universelle, ou GMT).

Les méthodes de date et les fuseaux horaires seront abordés dans les chapitres suivants.


Affichage des Dates

JavaScript affichera (par défaut) les dates en utilisant la méthode toString() . C'est une représentation sous forme de chaîne de la date, y compris le fuseau horaire. Le format est spécifié dans la spécification ECMAScript :

Lorsque vous affichez un objet date en HTML, il est automatiquement converti en chaîne, avec la méthode toString() .

Exemple

const d = new Date();
d.toString();
Essayez-le vous-même »

La méthode toDateString() convertit une date en un format plus lisible :

Exemple

const d = new Date();
d.toDateString();
Essayez-le vous-même »

La méthode toUTCString() convertit une date en une chaîne en utilisant la norme UTC :

Exemple

const d = new Date();
d.toUTCString();
Essayez-le vous-même »

La méthode toISOString() convertit une date en une chaîne en utilisant la norme ISO :

Exemple

const d = new Date();
d.toISOString();
Essayez-le vous-même »