Datum und Uhrzeit auf ein UTC-Intervall abrunden

Die Berechnung wandelt zuerst den angegebenen Z-Wert oder numerischen Versatz in UTC um und geht dann auf das seit der Unix-Epoche gemessene Vielfache des gewünschten Intervalls zurück. Sie verwendet ausschließlich die von Ihnen übermittelten Werte für Datumszeit, Intervall und Einheit. Dadurch eignet sich das Ergebnis für stabile Ereignisgruppen, Cache-Schlüssel, Berichtsfenster und Testdaten, ohne eine Uhr, Regionseinstellung, einen Netzwerkdienst oder die Zeitzone des Rechners abzufragen.

Wählen Sie einen eindeutigen Zeitpunkt und ein Intervall

Geben Sie eine vollständige ISO-8601-Datumszeit mit Kalenderdatum, Stunden, Minuten, Sekunden und entweder Z oder einem numerischen UTC-Versatz an. Der Versatz ist wichtig, weil eine lokale Uhrzeit allein keinen eindeutigen Zeitpunkt bezeichnet. 09:30 in New York und 09:30 in London liegen beispielsweise an verschiedenen Stellen der Zeitachse. Geben Sie anschließend ein positives ganzzahliges Intervall ein und wählen Sie Minute oder Sekunde als Einheit. Ein Intervall von 15 Minuten erzeugt Blöcke an vorhersehbaren UTC-Grenzen; ein Intervall von 20 Sekunden eignet sich für dichtere Ereignisströme. Minutenwerte dürfen zwischen 1 und 1440, Sekundenwerte zwischen 1 und 86400 liegen. Damit bleibt jede Anfrage auf höchstens einen Tag begrenzt. Sekundenbruchteile sind in der Datumszeit zulässig, doch die Abrundung arbeitet mit ganzen Sekunden und entfernt daher jeden Bruchteil. Die Antwort wiederholt Ihre Einstellungen, zeigt den normalisierten UTC-Zeitpunkt und gibt sowohl die abgerundete Datumszeit als auch ihren ganzzahligen Unix-Zeitstempel zurück, sodass Sie die passendere Darstellung verwenden können.

So funktioniert die UTC-Abrundungsregel

Der Vorgang wandelt die angegebene Datumszeit in eine ganzzahlige Sekundenzahl relativ zu 1970-01-01T00:00:00Z um. Danach wird das gewählte Intervall in Sekunden umgerechnet, eine mathematische Floor-Division angewendet und wieder mit der Intervallgröße multipliziert. Dies ist eine echte Abrundung und keine Rundung auf die nächste Grenze: 14:37:52Z wird bei 15 Minuten zu 14:30:00Z, niemals zu 14:45:00Z. Die Grenzen sind an der Unix-Epoche verankert. Das verhindert Mehrdeutigkeiten bei Intervallen, die eine Stunde nicht gleichmäßig teilen. Ein Sieben-Minuten-Intervall folgt etwa auf der weltweiten UTC-Zeitachse fortlaufenden Vielfachen von sieben Minuten, statt nach einer nicht genannten lokalen Konvention neu zu beginnen. Die mathematische Floor-Funktion ist auch vor 1970 entscheidend, da sie zur früheren Grenze geht und nicht gegen null abschneidet. Numerische Zeitzonenversätze werden vor der Blockauswahl aufgelöst, sodass gleichwertige Darstellungen desselben Zeitpunkts dasselbe Ergebnis liefern. Die Implementierung prüft gregorianische Daten und Uhrzeitfelder direkt und führt die Kalenderumwandlung mit Ganzzahlarithmetik aus; sie ruft weder Date auf noch übernimmt sie die Systemzeitzone.

Nutzen Sie stabile Blöcke in automatisierten Systemen

Eine abgerundete Datumszeit ist ein kompakter und nachvollziehbarer Blockschlüssel. Analysepipelines können eingehende Datensätze vor der Aggregation in identische Fenster gruppieren. Caches können Ablaufgruppen ableiten, ohne dass Millisekunden oder Zeitzoneneinstellungen des Clients gleichwertige Schlüssel aufspalten. Überwachungssysteme können Beobachtungen auf einen festen Takt normieren, und Tests können exakte Grenzen prüfen, ohne die Systemuhr einzufrieren. Speichern Sie floored_datetime, wenn Menschen oder Protokolle einen lesbaren UTC-Wert benötigen, oder verwenden Sie floored_epoch_seconds für numerische Vergleiche und Datenbankindizes. Weil das Ergebnis nur von den drei Eingabefeldern abhängt, liefert eine wiederholte Anfrage dasselbe Objekt; auch eine Verarbeitung außerhalb der Reihenfolge verändert frühere Antworten nicht. Der API-Preis beträgt $0.002 pro Element, während die Browser-Ausführung dieselbe reine Berechnung lokal erledigt. Diese Funktion ermittelt keine Zeitzone, liest nicht die aktuelle Uhrzeit, erstellt keine kalendarischen Monatsblöcke und rundet nicht auf. Beruht Ihre Geschäftsgrenze auf einer benannten Zeitzone mit Sommerzeit, lösen Sie diese Regel vorher auf und übergeben Sie den daraus entstandenen expliziten ISO-Versatz.