Deux jours d’écart, trois dates en incluant les bornes
De 2024-02-28 à 2024-03-01, l’écart est de deux jours. En incluant les bornes, on compte le 28 février, le 29 février et le 1er mars : trois dates. L’option d’inclusion de la date initiale de Moyoutil compte les deux bornes. Une même date vaut zéro par défaut, un jour avec inclusion.
dateDiff("2024-02-28", "2024-03-01", false) // 2
dateDiff("2024-02-28", "2024-03-01", true) // 3
dateDiff("2024-03-01", "2024-03-01", false) // 0
dateDiff("2024-03-01", "2024-03-01", true) // 1
Le résultat est négatif si la date finale précède la date initiale. Inverser cet exemple donne -2 par défaut, -3 avec inclusion. Le signe de la direction est conservé. Pour un nombre sans signe, vérifiez d’abord l’ordre des dates.
Années bissextiles : vérifier l’exception des siècles
Selon les règles grégoriennes d’ECMAScript, les années divisibles par 4 sont bissextiles, sauf celles divisibles par 100 qui doivent aussi l’être par 400. Ainsi 2000 est bissextile, 1900 ne l’est pas. La fonction réelle donne deux jours de 2000-02-28 à 2000-03-01 et un pour ces dates en 1900.
dateDiff("2000-02-28", "2000-03-01") // 2
dateDiff("1900-02-28", "1900-03-01") // 1Moyoutil ajoute T00:00:00Z pour calculer à minuit UTC et divise l’écart en millisecondes par 86400000. Dans ce modèle ECMAScript, un jour vaut 86400000 millisecondes. Les heures locales et changements d’heure d’été ne sont pas des entrées pour calculer le temps réellement écoulé.
Vérifier la base de calcul avant d’utiliser le résultat
Choisissez les dates initiale et finale. Vérifiez l’écart par défaut ou le nombre avec bornes incluses, et lisez la base affichée. Le résultat se met à jour lorsque les entrées changent. Années prises en charge : 0001–9999 ; dates inexistantes et entrées vides produisent des erreurs.
L’outil compte les dates calendaires sans exclure week-ends ou jours fériés. Il n’applique pas les règles particulières de jours ouvrés, hébergement, âge, fin de contrat ou délais légaux, et ne reconstruit pas les calendriers historiques régionaux. Vérifiez les règles du service ou de l’organisme.
Questions fréquemment posées
L’inclusion ajoute-t-elle toujours un au résultat ?
Non. Pour un écart négatif, elle soustrait un pour conserver la direction négative. Une même date incluse donne un jour.
Deux jours dans le résultat signifient-ils 48 heures réelles ?
L’outil compare les dates à minuit UTC. Les heures locales réelles et changements de fuseau ne sont pas renseignés ; le résultat seul ne détermine pas le temps réellement écoulé.