Timestamp de fin d'année

Limite de fin d'année

Pour la plupart des filtres de base de données, la limite propre est le début de l'année suivante à 00:00:00 UTC. Utilisez-la comme borne supérieure exclusive : created_at >= yearStart and created_at < nextYearStart.

Pourquoi les bornes supérieures exclusives sont plus sûres

Les bornes supérieures exclusives évitent les bugs de décalage d'une seconde et de précision à la milliseconde. Elles fonctionnent aussi proprement avec les bases de données qui stockent des fractions de seconde.

Utiliser la limite de fin d'année

L'horodatage de fin d'année le plus sûr est le premier instant de l'année suivante, utilisé comme borne supérieure exclusive. Il représente le point où l'année en cours s'arrête sans dépendre du fait que votre stockage conserve des secondes, millisecondes, microsecondes ou nanosecondes. Cela rend le même filtre portable entre les logs, les API et les bases de données SQL.

• Utilisez created_at < nextYearStart au lieu de created_at <= lastSecondOfYear
• Utilisez la valeur en millisecondes pour JavaScript et les plages de graphiques frontend
• Utilisez la valeur en secondes pour les outils Unix et la plupart des colonnes d'horodatage backend
• Associez la valeur à yearStart pour vérifier des plages annuelles complètes

Vérifier la valeur de fin d'année

Reconvertissez la valeur copiée en UTC et confirmez qu'elle est le 1er janvier à 00:00:00 de l'année suivante. Bien qu'on l'appelle fin d'année, cette limite est volontairement le premier instant après l'année, ce qui garde les filtres de base de données propres aux précisions seconde, milliseconde et microseconde. Cela évite aussi de décider si le dernier enregistrement stocké utilise 23:59:59, 23:59:59.999 ou une valeur fractionnaire plus fine.