Calcul de la durée commune à deux intervalles

Indiquez le début et la fin de chacun au format ISO 8601, avec Z ou un décalage UTC numérique. Le calcul ramène toutes les bornes sur la même chronologie UTC, retient le début le plus tardif et la fin la plus précoce, puis renvoie la durée partagée en millisecondes, secondes, minutes et heures. Des intervalles séparés ou simplement contigus donnent zéro, ce qui simplifie la planification, la facturation, la supervision et les rapports.

Définissez deux intervalles aux bornes sans ambiguïté

Saisissez quatre valeurs : le début et la fin du premier intervalle, puis le début et la fin du second. Chaque valeur doit être une date-heure ISO 8601 complète comprenant une date civile, une heure avec secondes et soit Z, soit un décalage explicite comme +02:00 ou -05:30. L’obligation d’indiquer le décalage empêche qu’une heure locale soit interprétée différemment sur une autre machine. Chaque début doit précéder la fin correspondante. Le calculateur utilise des intervalles semi-ouverts : le début appartient à l’intervalle, tandis que la fin constitue une borne exclue. Cette convention évite de compter deux fois le même instant lorsque des réservations, équipes ou fenêtres successives se rejoignent. Une à trois décimales de seconde sont acceptées et normalisées en millisecondes. Les dates et heures sont validées directement : une valeur impossible provoque donc une erreur de saisie. Utilisez toujours les quatre mêmes champs, qu’un chevauchement soit attendu ou non.

Comprenez le calcul UTC déterministe

Le calcul place les quatre bornes sur une seule chronologie UTC avant toute comparaison. Une valeur terminée par Z est déjà en UTC. Un décalage positif est retranché, tandis qu’un décalage négatif est ajouté. Deux écritures différentes peuvent ainsi désigner exactement le même instant. Le chevauchement commence au plus tardif des deux débuts et se termine à la plus précoce des deux fins. Si cette fin suit le début calculé, leur différence est la durée commune ; sinon, le résultat vaut exactement zéro. L’implémentation repose sur l’arithmétique du calendrier grégorien et sur des millisecondes entières. Elle ne consulte ni horloge, ni paramètres régionaux, ni base de fuseaux horaires, ni réseau, ni hasard, ni objet Date de JavaScript. Des entrées identiques produisent donc toujours le même résultat. La sortie exprime une durée unique en millisecondes, secondes, minutes et heures afin que vous choisissiez l’unité adaptée à votre système.

Exploitez le résultat de manière sûre

Utilisez cette durée dès que deux fenêtres connues doivent être comparées : un poste face à un congé approuvé, le fonctionnement d’un équipement face à une plage tarifaire, un incident face aux heures de service ou une réservation face à une disponibilité. Une valeur positive indique la quantité de temps partagée, et pas seulement l’existence d’une intersection. Zéro signifie que les intervalles sont séparés ou que l’un finit exactement quand l’autre commence ; dans les deux cas, aucun temps écoulé n’est commun selon la convention semi-ouverte. Pour un montant ou un quota, prenez overlap_milliseconds ou overlap_seconds comme valeur source, puis appliquez votre règle d’arrondi documentée. N’arrondissez pas les bornes au préalable sauf exigence métier. Le service accepte uniquement des décalages explicites, pas des noms comme America/New_York, et ne déduit aucune règle saisonnière. Convertissez d’abord les heures locales. Chaque appel API coûte $0.002 ; le navigateur permet aussi un contrôle interactif local.