Timestamp di inizio anno
Trova il timestamp Unix del 1° gennaio alle 00:00:00 UTC dell'anno corrente, più i comuni confini di data vicini.
Inizio dell'anno corrente
I timestamp di inizio anno sono utili per aggregazioni dall'inizio dell'anno, riepiloghi annuali, report di fatturazione e fixture di test che hanno bisogno di un confine di calendario stabile.
Confine UTC
Il valore di inizio anno su questa pagina è il 1° gennaio alle 00:00:00 UTC. Se la tua logica di business usa un fuso aziendale locale, converti il confine prima di scrivere filtri di database.
Quando i timestamp di inizio anno sono utili
L'inizio dell'anno è un'ancora comune per reporting e dati di test. Usalo per costruire dashboard dall'inizio dell'anno, intervalli di fatturazione annuale, calcoli di retention e fixture che devono aggiornarsi automaticamente al variare del calendario. Abbinalo al confine dell'anno successivo quando interroghi periodi annuali completi.
- Usa yearStart come limite inferiore per i report dall'inizio dell'anno
- Usa nextYearStart come limite superiore esclusivo per un anno solare completo
- Usa UTC quando il report copre più regioni o servizi backend
- Usa un fuso aziendale solo quando regole contabili o di prodotto definiscono l'anno localmente
Verificare il valore di inizio anno
Riconverti il timestamp in una data UTC e conferma che indichi il 1° gennaio alle 00:00:00 per l'anno corrente. Se il tuo report usa un anno fiscale o un fuso aziendale locale, genera un confine separato per quella regola invece di riutilizzare il valore dell'anno solare UTC. Tieni la definizione scelta accanto alla query così i futuri manutentori sapranno perché è stato scelto il confine e quale fuso è stato usato.