Calcolo della durata sovrapposta tra due intervalli

Inserisca l’inizio e la fine di ciascun intervallo in formato ISO 8601, includendo Z oppure un offset UTC numerico. Il calcolo porta ogni estremo sulla stessa linea temporale UTC, sceglie l’inizio più tardo e la fine più anticipata e restituisce la durata comune in millisecondi, secondi, minuti e ore. Intervalli separati o che si toccano soltanto restituiscono zero, rendendo il risultato pratico per pianificazione, fatturazione, monitoraggio e reportistica.

Definisca entrambi gli intervalli senza ambiguità

Inserisca quattro valori: inizio e fine del primo intervallo, quindi inizio e fine del secondo. Ogni valore deve essere una data e ora ISO 8601 completa, con data di calendario, orario comprensivo di secondi e Z oppure un offset esplicito come +02:00 o -05:30. Rendere obbligatorio l’offset impedisce che un orario locale venga interpretato diversamente su un altro computer. Ogni inizio deve precedere la relativa fine. Il calcolatore considera gli intervalli semiaperti: l’inizio appartiene all’intervallo, mentre la fine è un limite escluso. Questa convenzione evita di conteggiare due volte lo stesso istante quando prenotazioni, turni o finestre consecutivi si incontrano. Sono accettate da una a tre cifre decimali per i secondi, normalizzate in millisecondi. Date e componenti orarie vengono convalidati direttamente, quindi valori impossibili producono un errore di input. Utilizzi sempre gli stessi quattro campi, indipendentemente dal fatto che si aspetti o meno una sovrapposizione.

Comprenda il calcolo deterministico in UTC

Prima del confronto, il calcolo colloca i quattro estremi su un’unica linea temporale UTC. Un valore che termina con Z è già espresso in UTC. Da un valore con offset positivo viene sottratto l’offset, mentre a uno con offset negativo esso viene aggiunto. Due date scritte diversamente possono quindi indicare lo stesso istante. La sovrapposizione comincia dal più tardo dei due inizi e termina alla più anticipata delle due fini. Se tale fine è successiva all’inizio calcolato, la differenza costituisce la durata comune; altrimenti il risultato è esattamente zero. L’implementazione usa aritmetica del calendario gregoriano e millisecondi interi, senza consultare orologio, impostazioni locali, archivio dei fusi, rete, casualità o Date di JavaScript. Input identici producono sempre risultati identici. L’output esprime la stessa durata in millisecondi, secondi, minuti e ore, così Lei può scegliere l’unità più adatta al proprio sistema.

Applichi il risultato in modo sicuro

Utilizzi la durata di sovrapposizione quando deve confrontare due finestre note: un turno con un’assenza autorizzata, il funzionamento di un’apparecchiatura con una fascia tariffaria, un incidente con l’orario di assistenza o una prenotazione con una disponibilità. Un valore positivo indica quanto tempo è condiviso, non soltanto l’esistenza dell’intersezione. Zero significa che gli intervalli sono separati oppure che uno finisce nell’istante esatto in cui comincia l’altro; in entrambi i casi non condividono tempo trascorso secondo la convenzione semiaperta. Per importi o quote, usi overlap_milliseconds o overlap_seconds come valore sorgente e applichi solo dopo la propria regola di arrotondamento documentata. Non arrotondi preventivamente gli estremi salvo necessità aziendale. L’endpoint accetta soltanto offset espliciti, non nomi come America/New_York, e non deduce regole stagionali. Converta prima gli orari locali. Ogni richiesta API costa $0.002; il browser offre anche verifiche interattive locali.