Überlappungsdauer zweier Zeitintervalle berechnen

Geben Sie Anfang und Ende jedes Intervalls im ISO-8601-Format mit Z oder einem numerischen UTC-Offset ein. Die Berechnung überführt alle Grenzen auf dieselbe UTC-Zeitachse, wählt den späteren Anfang und das frühere Ende und gibt die gemeinsame Dauer in Millisekunden, Sekunden, Minuten und Stunden aus. Getrennte Intervalle sowie Bereiche, die sich nur berühren, ergeben null und lassen sich dadurch einfach für Planung, Abrechnung, Überwachung und Berichte verwenden.

Legen Sie beide Intervalle eindeutig fest

Geben Sie vier Werte ein: Anfang und Ende des ersten Intervalls, gefolgt von Anfang und Ende des zweiten. Jeder Wert muss ein vollständiger ISO-8601-Zeitstempel mit Kalenderdatum, Uhrzeit einschließlich Sekunden und entweder Z oder einem ausdrücklichen Offset wie +02:00 oder -05:30 sein. Der vorgeschriebene Offset verhindert, dass eine lokale Uhrzeit auf einem anderen Rechner anders ausgelegt wird. Jeder Anfang muss vor dem zugehörigen Ende liegen. Der Rechner behandelt die Intervalle als halboffene Bereiche: Der Anfang gehört dazu, das Ende bildet eine ausgeschlossene Grenze. So wird derselbe Zeitpunkt nicht doppelt gezählt, wenn aufeinanderfolgende Buchungen, Schichten oder Verarbeitungsfenster zusammentreffen. Für Sekunden sind eine bis drei Nachkommastellen zulässig; sie werden auf Millisekunden normiert. Kalenderdaten und Uhrzeitbestandteile werden unmittelbar geprüft, sodass unmögliche Angaben einen Eingabefehler auslösen. Verwenden Sie stets dieselben vier Felder, unabhängig davon, ob Sie eine Überschneidung erwarten.

So funktioniert die deterministische UTC-Berechnung

Vor dem Vergleich setzt die Berechnung alle vier Grenzen auf eine gemeinsame UTC-Zeitachse. Ein mit Z endender Wert liegt bereits in UTC vor. Bei einem positiven Offset wird dieser abgezogen, bei einem negativen dagegen addiert. Deshalb können unterschiedlich geschriebene Zeitstempel denselben Zeitpunkt bezeichnen. Die Überschneidung beginnt mit dem späteren der beiden Anfänge und endet mit dem früheren der beiden Enden. Liegt dieses Ende nach dem berechneten Anfang, ist die Differenz die gemeinsame Dauer; andernfalls beträgt sie genau null. Die Implementierung verwendet gregorianische Kalenderarithmetik und ganzzahlige Millisekunden. Sie greift weder auf Rechneruhr, Gebietsschema, Zeitzonendatenbank, Netzwerk, Zufall noch auf JavaScript Date zurück. Gleiche Eingaben führen daher immer zum gleichen Ergebnis. Die Ausgabe stellt dieselbe Dauer in Millisekunden, Sekunden, Minuten und Stunden bereit, damit Sie die passende Einheit für Datenbank, Rechnung, Anzeige oder Planungsregel auswählen können.

Setzen Sie das Ergebnis sicher ein

Nutzen Sie die Überschneidungsdauer, wenn zwei bekannte Zeitfenster verglichen werden müssen: eine Schicht mit genehmigter Abwesenheit, eine Maschinenlaufzeit mit einem Tarifzeitraum, ein Vorfall mit einem Servicefenster oder eine Buchung mit einem verfügbaren Block. Ein positiver Wert zeigt die gemeinsame Zeitmenge und nicht nur das Vorhandensein einer Überschneidung. Null bedeutet, dass die Intervalle getrennt sind oder dass eines genau beim Beginn des anderen endet; nach der halboffenen Konvention gibt es in beiden Fällen keine gemeinsam verstrichene Zeit. Verwenden Sie für Beträge oder Kontingente overlap_milliseconds oder overlap_seconds als Ausgangswert und wenden Sie Ihre dokumentierte Rundung erst danach an. Runden Sie Grenzen nicht vorher, außer Ihre Fachregel verlangt dies. Der Endpunkt verarbeitet nur ausdrückliche Offsets, keine Namen wie America/New_York, und leitet keine Sommerzeitregeln ab. Wandeln Sie lokale Zeiten vorher um. Ein API-Aufruf kostet $0.002; im Browser ist dieselbe Berechnung interaktiv lokal möglich.