Tronquer date-heure à l'unité

Tronquer un horodatage à une unité plus grossière est le fondement des buckets quotidiens, des rapports mensuels, des graphiques horaires et des clés de cache qui doivent s'accorder entre langues et hôtes. Cet outil de troncature date-heure à l'unité accepte une date-heure ISO-8601 explicite —heure complète avec Z ou un décalage numérique, ou une chaîne date seule traitée comme minuit UTC— plus une unité année, mois, jour, heure ou minute. Il normalise l'entrée en Temps universel coordonné avec une arithmétique grégorienne pure, puis met à zéro tout champ plus fin que l'unité choisie, de sorte que le résultat soit un instant de plancher UTC stable écrit année-mois-jour T heure-minute-seconde Z. Les jours de calendrier impossibles et les unités inconnues échouent avec une erreur de validation claire au lieu d'inventer un report.

Comment la troncature UTC fonctionne sans horloge système

Partez d'une date-heure de base explicite écrite sous la forme internationale ISO pour que chaque client s'accorde sur la même année, le même mois, le même jour et les champs d'horloge optionnels. Lorsqu'une seule date de calendrier est fournie, traitez-la comme minuit en Temps universel coordonné. Lorsqu'une heure est présente, acceptez des fractions de seconde optionnelles tronquées à des secondes entières et soit un Z final pour UTC, soit un décalage numérique d'heures et de minutes avec signe plus ou moins, soustrait lors de la conversion en temps absolu.

Validez que le jour civil existe selon les règles grégoriennes de bissextilité —le 29 février n'est légal que si l'année est divisible par quatre, sauf que les années séculaires doivent aussi l'être par quatre cents— et que heure, minute et seconde restent dans leurs plages usuelles. Convertissez le triple civil en un numéro de jour sériel avec l'algorithme days-from-civil de Howard Hinnant, multipliez par quatre-vingt-quatre mille six cents secondes, ajoutez l'heure locale du jour et soustrayez les minutes de décalage multipliées par soixante pour obtenir les secondes d'époque UTC.

Reconstruisez année, mois, jour, heure, minute et seconde UTC avec civil-from-days. Appliquez ensuite un plancher pur par unité : year remet le mois à un et le jour à un avec l'horloge à zéro ; month conserve année et mois mais fixe le jour à un et l'horloge à zéro ; day conserve la date de calendrier et met l'horloge à zéro ; hour met à zéro minute et seconde ; minute met à zéro uniquement la seconde. Formatez les champs civils tronqués en chaîne quatre-deux-deux T deux-deux-deux Z.

Où les calculateurs de troncature date-heure à l'unité sont utiles

Les pipelines d'analytique matérialisent des clés d'événements quotidiennes et horaires en abaissant les horodatages d'ingestion au plancher, afin que chaque langue et région partage le même bucket UTC sans inventer une bibliothèque de calendrier. Les équipes finance et opérations regroupent lignes de grand livre ou tickets de support en périodes mois ou jour pour des synthèses déterministes alignées sur les audits hors ligne.

Les tableaux de bord produit et croissance tracent l'activité par heure ou jour avec un plancher stable pour que les aperçus navigateur et les agrégations backend ne divergent jamais d'une heure aux transitions d'heure d'été.

Si vous devez plus tard ajouter des heures ou des jours à un horodatage, compter les jours entre deux dates, calculer début et fin de mois, ou convertir des unités de temps pures entre heures et minutes, traitez-les comme des intentions de recherche et des pages distinctes plutôt que de surcharger cette page de troncature date-heure à l'unité : ces problèmes répondent à d'autres requêtes même si une partie de l'arithmétique se ressemble en dessous.