Timestamp de début d'année

Début de l'année en cours

Les horodatages de début d'année sont utiles pour les agrégations cumul annuel, les récapitulatifs annuels, les rapports de facturation et les fixtures de test qui ont besoin d'une limite de calendrier stable.

Limite UTC

La valeur de début d'année sur cette page est le 1er janvier à 00:00:00 UTC. Si votre logique métier utilise un fuseau d'affaires local, convertissez la limite avant d'écrire des filtres de base de données.

Quand les horodatages de début d'année sont utiles

Le début de l'année est un ancrage courant pour le reporting et les données de test. Utilisez-le pour construire des tableaux de bord cumul annuel, des plages de facturation annuelle, des calculs de rétention et des fixtures qui doivent se mettre à jour automatiquement au fil du calendrier. Associez-le à la limite de l'année suivante pour interroger des périodes annuelles complètes.

• Utilisez yearStart comme borne inférieure pour les rapports cumul annuel
• Utilisez nextYearStart comme borne supérieure exclusive pour une année civile complète
• Utilisez l'UTC quand le rapport couvre plusieurs régions ou services backend
• Utilisez un fuseau d'affaires uniquement quand des règles comptables ou produit définissent l'année localement

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

Reconvertissez l'horodatage en date UTC et confirmez qu'il indique le 1er janvier à 00:00:00 pour l'année en cours. Si votre rapport utilise une année fiscale ou un fuseau d'affaires local, générez une limite distincte pour cette règle au lieu de réutiliser la valeur de l'année civile UTC. Gardez la définition choisie à côté de la requête pour que les futurs mainteneurs sachent pourquoi la limite a été choisie et quel fuseau a été utilisé.