Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
JavaScript

L'objet Date en JavaScript

L'objet Date en JavaScript. Dans cette leçon du cours JavaScript, vous apprendrez à : créer une date de plusieurs façons, sans se tromper de mois ; lire et modifier les composants d'une date ; calcule...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

L'objet Date en JavaScript. Dans cette leçon du cours JavaScript, vous apprendrez à : créer une date de plusieurs façons, sans se tromper de mois ; lire et modifier les composants d'une date ; calculer une durée, une échéance ou un âge ; connaître les pièges des fuseaux horaires et des formats.

Chapitre 11 — Les objets prédéfinis et l'ordonnancement · L'objet Date en JavaScript

🎯 Objectifs de la leçon
• créer une date de plusieurs façons, sans se tromper de mois ;
• lire et modifier les composants d'une date ;
• calculer une durée, une échéance ou un âge ;
• connaître les pièges des fuseaux horaires et des formats.

1. Une date, c'est un nombre

Un objet Date représente un instant précis, stocké sous la forme d'un nombre de millisecondes écoulées depuis le 1er janvier 1970 à minuit UTC (l'« époque Unix »). Toutes les méthodes ne font que traduire ce nombre en année, mois, jour, heure… dans le fuseau horaire de l'ordinateur.

Les composants d'une date
Figure 1 — Les getters d'une date. Attention aux deux cases rouges : les mois et les jours de la semaine commencent à 0.

2. Créer, lire, modifier, calculer

// Créer une date
const d1 = new Date(2026, 10, 14, 9, 30);      // 14 novembre 2026, 9 h 30 (les mois vont de 0 à 11 !)
const d2 = new Date("2026-11-14T09:30:00");    // format ISO, heure locale
const d3 = new Date(0);                        // 1er janvier 1970 à 00:00 UTC (l'« époque »)
console.log(d1.toLocaleString("fr-FR"), "|", d1.getTime() === d2.getTime());
console.log("new Date(0) =", d3.toISOString());

// Lire les composants
console.log(`année ${d1.getFullYear()}, mois ${d1.getMonth()} (+1 = ${d1.getMonth() + 1}), jour ${d1.getDate()}, jour de la semaine ${d1.getDay()} (0 = dimanche)`);
console.log(`heures ${d1.getHours()}, minutes ${d1.getMinutes()}, horodatage ${d1.getTime()} ms`);

// Modifier : les débordements sont corrigés automatiquement
const d4 = new Date(2026, 0, 31);   // 31 janvier
d4.setMonth(1);                     // « 31 février » → 3 mars
console.log("31 janvier + setMonth(1) →", d4.toLocaleDateString("fr-FR"));
const d5 = new Date(2026, 10, 14);
d5.setDate(d5.getDate() + 30);      // ajouter 30 jours
console.log("14/11/2026 + 30 jours →", d5.toLocaleDateString("fr-FR"));

// Calculer une durée : soustraire deux dates donne des millisecondes
const rentree = new Date(2026, 8, 7);
const examen = new Date(2027, 5, 14);
const jours = Math.round((examen - rentree) / (1000 * 60 * 60 * 24));
console.log(`De la rentrée à l'examen : ${jours} jours, soit environ ${Math.floor(jours / 7)} semaines`);

// Calculer un âge
function age(naissance, ref = new Date(2026, 10, 14)) {
  let a = ref.getFullYear() - naissance.getFullYear();
  const pasEncore = ref.getMonth() < naissance.getMonth() ||
    (ref.getMonth() === naissance.getMonth() && ref.getDate() < naissance.getDate());
  return pasEncore ? a - 1 : a;
}
console.log("Né le 20/12/2006 → âge au 14/11/2026 :", age(new Date(2006, 11, 20)), "ans");

// Comparer deux dates
console.log("rentree < examen ?", rentree < examen, "| égales ?", new Date(2026, 8, 7).getTime() === rentree.getTime());

// Piège : une date SEULE au format ISO est lue en UTC, une date AVEC heure en heure locale
console.log('new Date("2026-11-14").getHours()       =', new Date("2026-11-14").getHours(), "(minuit UTC, affiché en heure locale UTC+1)");
console.log('new Date("2026-11-14T00:00").getHours() =', new Date("2026-11-14T00:00").getHours());

Résultat dans la console (ordinateur réglé à l'heure UTC+1)

14/11/2026 09:30:00 | true
new Date(0) = 1970-01-01T00:00:00.000Z
année 2026, mois 10 (+1 = 11), jour 14, jour de la semaine 6 (0 = dimanche)
heures 9, minutes 30, horodatage 1794645000000 ms
31 janvier + setMonth(1) → 03/03/2026
14/11/2026 + 30 jours → 14/12/2026
De la rentrée à l'examen : 280 jours, soit environ 40 semaines
Né le 20/12/2006 → âge au 14/11/2026 : 19 ans
rentree < examen ? true | égales ? true
new Date("2026-11-14").getHours()       = 1 (minuit UTC, affiché en heure locale UTC+1)
new Date("2026-11-14T00:00").getHours() = 0

Créer une date

  • new Date(): maintenant.
  • new Date(annee, mois, jour, heures, minutes): le mois commence à 0 (0 = janvier, 11 = décembre).
  • new Date("2026-11-14T09:30:00"): le format ISO, le plus sûr pour une chaîne. Évitez les formats comme "14/11/2026", interprétés différemment selon les navigateurs.
  • new Date(millisecondes) et Date.now() (le nombre de millisecondes actuel, sans créer d'objet).

Lire et modifier

Les getters (getFullYear, getMonth, getDate, getDay, getHours…) ont tous un setter (setFullYear, setMonth, setDate…). Les setters corrigent les débordements : ajouter 30 jours avec setDate(getDate() + 30) passe correctement au mois suivant. Il existe aussi des versions UTC (getUTCHours…).

Calculer

Soustraire deux dates donne une durée en millisecondes : on divise par 1000 * 60 * 60 * 24 pour obtenir des jours. Les comparaisons < et > fonctionnent directement ; pour l'égalité, comparez getTime(), car deux objets différents ne sont jamais égaux avec ===.

✅ Correction par rapport à l'ancienne version
Cette leçon a été mise à jour. L'ancien exemple new Date(2018,12,31,00,00,00) ne crée pas le 31 décembre 2018 mais le 31 janvier 2019: le mois 12 n'existe pas (décembre = 11) et déborde sur l'année suivante. La méthode getYear() est obsolète (elle renvoie l'année moins 1900) : utilisez getFullYear(). Les activités corrigées utilisaient document.write, alert et onload; elles sont remplacées par une activité guidée, et l'affichage des dates en français est traité avec Intl à la leçon 11.4.
ℹ️ À retenir
• Une date est un nombre de millisecondes depuis le 1er janvier 1970 UTC.
• Les mois vont de 0 à 11, les jours de la semaine de 0 (dimanche) à 6 ; getDate() donne le jour du mois.
• date2 - date1 = durée en millisecondes ; les setters corrigent les débordements.
• Chaînes au format ISO uniquement ; une date seule ("2026-11-14") est lue en UTC.

🛠 Activité 3 — Le planning de la formation

Mission : Réalisez un petit outil qui affiche des informations sur le calendrier de votre formation.

Questions pour avancer (répondez dans votre compte rendu, puis appliquez dans votre projet) :

  1. Créez la date de début de la formation et la date de l'examen final. Pourquoi new Date(2027, 6, 14) ne donne-t-il pas le 14 juin ?
  2. Affichez le nombre de jours restants avant l'examen à partir d'aujourd'hui. Comment arrondissez-vous le résultat, et pourquoi ?
  3. Affichez la date du jour au format JJ/MM/AAAA en construisant la chaîne vous-même. Comment obtenez-vous « 05 » au lieu de « 5 » ? (indice : une méthode des chaînes)
  4. Un stage dure 8 semaines à partir d'une date donnée. Calculez sa date de fin. Testez avec un début le 15 décembre : le passage à l'année suivante est-il correct ?
  5. Écrivez une fonction estWeekEnd(date). Quelle méthode utilisez-vous, et quelles valeurs testez-vous ?
  6. Créez new Date("2026-11-14") et new Date("2026-11-14T00:00"), puis affichez getHours(). Expliquez la différence.

Je vérifie / je rends :

  • ☐ Le script et l'explication de la question 6.

← L'objet Math en JavaScriptFormater les dates et les nombres avec Intl →

Cet article vous a-t-il aidé ?