Arrondir une date-heure à l’intervalle UTC inférieur

Le calcul convertit d’abord en UTC la valeur Z ou le décalage numérique fourni, puis descend au multiple de l’intervalle demandé mesuré depuis l’époque Unix. Il utilise uniquement la date-heure, l’intervalle et l’unité que vous indiquez. Le résultat convient donc au regroupement stable d’événements, aux clés de cache, aux fenêtres de rapport et aux jeux de test, sans consulter d’horloge, de paramètres régionaux, de service réseau ni de fuseau système.

Choisissez un instant et un intervalle explicites

Fournissez une date-heure ISO-8601 complète comprenant la date civile, les heures, minutes et secondes, ainsi que Z ou un décalage UTC numérique. Ce décalage est indispensable, car une heure locale seule ne désigne pas un instant unique. Par exemple, 09:30 à New York et 09:30 à Londres correspondent à deux points distincts de la chronologie. Indiquez ensuite un intervalle entier positif et choisissez la minute ou la seconde comme unité. Un intervalle de 15 minutes crée des créneaux sur des limites UTC prévisibles, tandis qu’un intervalle de 20 secondes convient aux flux d’événements plus denses. Les minutes vont de 1 à 1440 et les secondes de 1 à 86400, ce qui borne chaque demande à une journée au maximum. Les fractions de seconde sont admises dans la date-heure explicite, mais l’arrondi travaille à la seconde entière et supprime donc toute fraction. La réponse rappelle les paramètres, affiche l’instant UTC normalisé et renvoie à la fois la date-heure arrondie et son horodatage Unix entier, afin que vous puissiez choisir la représentation la mieux adaptée.

Comprenez la règle d’arrondi inférieur en UTC

L’opération convertit la date-heure fournie en un nombre entier de secondes depuis 1970-01-01T00:00:00Z. Elle convertit l’intervalle choisi en secondes, applique une division mathématique par plancher, puis remultiplie par la taille de l’intervalle. Il s’agit bien d’un arrondi inférieur, et non d’un arrondi à la limite la plus proche : 14:37:52Z ramené à 15 minutes devient 14:30:00Z, jamais 14:45:00Z. Les limites sont ancrées à l’époque Unix, ce qui lève toute ambiguïté pour les intervalles qui ne divisent pas uniformément une heure. Un intervalle de sept minutes suit ainsi des multiples consécutifs de sept minutes sur la chronologie UTC mondiale, au lieu de redémarrer selon une convention locale implicite. Le plancher mathématique est également essentiel avant 1970, puisqu’il mène à la limite antérieure au lieu de tronquer vers zéro. Les décalages numériques sont résolus avant la sélection du créneau : deux écritures équivalentes du même instant donnent donc le même résultat. L’implémentation valide directement les dates grégoriennes et les champs horaires, puis effectue la conversion civile en arithmétique entière sans appeler Date ni reprendre le fuseau du système.

Employez des créneaux stables dans vos automatismes

Une date-heure arrondie constitue une clé de créneau compacte et explicable. Les pipelines analytiques peuvent regrouper les enregistrements entrants dans des fenêtres identiques avant leur agrégation. Les caches peuvent établir des groupes d’expiration sans laisser les millisecondes ou le fuseau du client fragmenter des clés pourtant équivalentes. Les systèmes de supervision peuvent normaliser les observations à une cadence fixe, et les tests vérifier des limites exactes sans figer l’horloge système. Conservez floored_datetime lorsqu’une personne ou un journal a besoin d’une valeur UTC lisible, ou employez floored_epoch_seconds pour les comparaisons numériques et les index de base de données. Puisque le résultat dépend uniquement des trois champs d’entrée, une nouvelle tentative produit le même objet et le traitement désordonné des enregistrements ne modifie aucune réponse antérieure. Le tarif de l’API est de $0.002 par élément, tandis que l’exécuteur du navigateur réalise localement le même calcul pur. Cette capacité ne déduit aucun fuseau, ne lit pas l’heure courante, ne crée pas de créneaux mensuels civils et n’arrondit pas vers le haut. Si votre limite métier dépend d’un fuseau nommé soumis à l’heure d’été, résolvez cette règle en amont et transmettez le décalage ISO explicite obtenu.