Calculateur de Différence de Dates

Un calculateur de différence de dates mesure l’écart entre deux dates du calendrier et l’exprime en jours, semaines, mois approximatifs, années approximatives, ainsi qu’en heures ou minutes. Il sert à vérifier la durée d’un projet, une période de congé, un cycle de facturation, un anniversaire, une durée de conservation ou un intervalle historique simple. Le résultat est une différence entre dates, pas forcément un comptage incluant les deux extrémités : du 1er janvier au 3 janvier, l’écart est normalement de deux jours, sauf règle métier contraire. Les mois et les années sont souvent approximatifs, car les mois n’ont pas tous la même longueur. Pour les jours ouvrés, jours fériés, fuseaux horaires ou délais légaux, utilisez les règles adaptées.

La différence exacte en jours est calculée par Math.floor((end.getTime() - start.getTime()) / 86_400_000), où 86 400 000 est le nombre de millisecondes dans une journée de 24 heures sans changement d'heure. Cela donne un intervalle exclusif — du 1er janvier au 3 janvier fait 2 jours, pas 3 — car la soustraction mesure l'écart entre deux instants plutôt que de compter les cases du calendrier. Pour un comptage inclusif (compter les deux extrémités), il faut ajouter 1 au résultat ; de nombreuses règles juridiques, de congés et de facturation l'exigent et cette erreur d'un jour est la cause la plus fréquente de divergences entre les rapports RH et finance. Les semaines sont simplement jours / 7 ; la page affiche aussi heures = jours * 24, minutes = jours * 1440 et secondes = jours * 86 400 comme totaux dérivés. Les différences en mois et années sont délibérément étiquetées « approximatives » car les mois et années calendaires varient en durée. L'approche simple est jours / 30,436875 (mois grégorien moyen) et jours / 365,2425 (année grégorienne moyenne sur un cycle de 400 ans), ce qui convient aux rapports de statut et tableaux de bord mais est inexact pour les contrats. Pour un « X mois complets entre » calendaire précis, l'algorithme soustrait les composantes année x 12 + mois puis décrémente de 1 si le jour de fin est antérieur au jour de début — c'est ainsi que la plupart des bibliothèques de dates (differenceInMonths de date-fns, $.diff('month') de dayjs, Duration.from de Temporal) le calculent. Le calcul d'années a la même particularité : du 29/02/2024 au 28/02/2025 est parfois compté comme 1 an (en ajustant au dernier jour du mois) et parfois comme 0 an 11 mois et 30 jours, selon la convention. Les années bissextiles suivent la règle grégorienne (divisibles par 4, sauf les siècles non divisibles par 400, donc 1900 = commune, 2000 = bissextile, 2024 = bissextile). Un intervalle incluant le 29 février gagne automatiquement un jour supplémentaire car le comptage de jours est ancré sur les millisecondes depuis l'époque, pas sur les champs calendaires. La gestion des fuseaux horaires est critique lorsque les deux extrémités sont à une résolution inférieure au jour : la soustraction de deux valeurs Date construites à partir de chaînes en heure locale peut être décalée du décalage UTC local, et un intervalle traversant un changement d'heure peut faire 23 ou 25 heures plutôt que les 24 nominaux. Le problème Y2038 (débordement du time_t Unix signé 32 bits le 2038-01-19T03:14:07Z) n'affecte pas cette page car JavaScript Date utilise un flottant 64 bits capable de représenter des dates jusqu'à environ 100 millions de jours de part et d'autre de l'époque, mais les systèmes aval écrit en C 32 bits nécessitent encore une attention particulière.

• Jours exacts = Math.floor((end - start) / 86_400_000) ; 86,4 M ms par jour sans changement d'heure.
• Le résultat est exclusif par défaut : 1er jan au 3 jan = 2 jours ; ajouter 1 pour un comptage inclusif (les deux extrémités).
• Le mois approximatif utilise une moyenne de 30,436875 jours ; l'année utilise 365,2425 jours sur le cycle grégorien de 400 ans.
• Différence de mois calendaire précise : (a2-a1)*12 + (m2-m1) puis -1 si jour de fin < jour de début — correspond à differenceInMonths de date-fns.
• Années bissextiles : divisibles par 4, sauf les siècles qui doivent être divisibles par 400 (1900 non, 2000 oui, 2024 oui).
• Les transitions d'heure d'été créent des journées calendaire de 23h et 25h ; une soustraction de 24h peut ne pas égaler un jour calendaire.
• JavaScript Date est un flottant 64 bits, immunisé contre le Y2038 Unix (débordement time_t 32 bits le 2038-01-19 03:14:07 UTC).