Durée totale d'intervalles de temps

Les équipes d’exploitation, les scripts de paie et les outils de SLA gèrent souvent de nombreux intervalles de temps explicites qui se chevauchent : astreintes, réservations d’équipements, fenêtres d’indisponibilité ou sessions facturables. Sommer chaque intervalle de façon naïve compte deux fois les minutes partagées. Ce calculateur de durée totale d’intervalles de temps accepte une liste de paires début et fin ISO-8601, normalise chaque borne en UTC absolu par arithmétique grégorienne pure, fusionne les intervalles qui se chevauchent ou se touchent, et renvoie la longueur de la plage couverte en millisecondes, secondes et heures, plus une décomposition en jours, heures, minutes et secondes. Les réservations adjacentes qui se rejoignent à une extrémité deviennent un segment continu, de sorte qu’un point de contact de longueur nulle n’enfle jamais le total.

Ce que signifie la durée couverte après fusion des chevauchements

La durée couverte mesure l’union de vos intervalles sur la ligne de temps absolue, et non la somme de chaque longueur brute. Si Alice réserve de dix heures à douze heures et Bob de onze heures à treize heures le même jour UTC, la somme naïve est de cinq heures, alors que la plage couverte n’est que de trois heures de dix à treize.

Ce point d’accès applique l’algorithme classique de tri et fusion : chaque début et fin est converti en millisecondes d’époque UTC, la liste est ordonnée par heure de début, et chaque intervalle suivant soit prolonge le segment ouvert courant lorsqu’il commence à la fin de ce segment ou avant, soit ouvre un nouveau segment lorsqu’il existe un écart positif.

Les intervalles qui se touchent, par exemple se terminer à douze et commencer à douze, fusionnent en un bloc continu, le modèle correct de temps continu pour la couverture, l’occupation et la disponibilité SLA. Les intervalles de longueur nulle et inversés sont rejetés car ils ne définissent pas une plage ouverte positive.

Contrat d’entrée, bornes ISO et forme de la réponse

Chaque objet doit inclure les champs chaîne start et end au format ISO-8601 : année à quatre chiffres, mois et jour, éventuellement suivis d’une heure du jour avec heures, minutes, secondes et une partie fractionnaire optionnelle de seconde. Un Z final signifie UTC ; un décalage numérique tel que plus zéro deux deux-points zéro zéro ou moins zéro cinq deux-points zéro zéro décale les champs locaux en UTC absolu avant la fusion.

Les valeurs date seule sont traitées comme minuit UTC afin que les fenêtres journalières fonctionnent sans inventer une horloge. Les champs optionnels nuls ne sont jamais émis. Une validation en échec ne consomme pas le solde.

Où le total du temps couvert rend service

Les plateformes d’effectifs et d’astreinte fusionnent des fragments de vacation pour que la paie et les règles de fatigue facturent une couverture continue plutôt que des heures doubles chevauchées. Les systèmes de réservation d’installations et de laboratoires calculent l’occupation d’une salle ou d’un instrument lorsque les réservations s’empilent, alimentant des tableaux d’utilisation sans fonctions SQL de fenêtre à chaque rapport. Les pages de fiabilité et de statut transforment de nombreux intervalles d’incident partiels en une seule durée d’indisponibilité couverte pour le calcul mensuel de SLA.

Les suiveurs de temps de projet consolident des journaux de session en double issus de clients mobiles et de bureau qui ont enregistré le même travail deux fois avec des horloges légèrement différentes. Associez cet outil à l’intersection de deux intervalles lorsque vous avez besoin du chevauchement d’exactement deux plages, ou à des utilitaires d’humanisation de durée lorsque vous ne voulez qu’un texte lisible à partir d’un décompte de secondes.