Timestamp de início de ano

Início do ano atual

As marcas de tempo de início de ano são úteis para agregações do ano até a data, resumos anuais, relatórios de faturamento e fixtures de teste que precisam de um limite de calendário estável.

Limite UTC

O valor de início de ano nesta página é 1º de janeiro às 00:00:00 UTC. Se a sua lógica de negócio usa um fuso de negócio local, converta o limite antes de escrever filtros de banco de dados.

Quando as marcas de tempo de início de ano são úteis

O início do ano é uma âncora comum para relatórios e dados de teste. Use-o para construir painéis do ano até a data, intervalos de faturamento anual, cálculos de retenção e fixtures que devem se atualizar automaticamente conforme o calendário muda. Combine-o com o limite do ano seguinte ao consultar períodos anuais completos.

• Use yearStart como limite inferior para relatórios do ano até a data
• Use nextYearStart como limite superior exclusivo para um ano civil completo
• Use UTC quando o relatório abranger várias regiões ou serviços de backend
• Use um fuso de negócio apenas quando regras contábeis ou de produto definirem o ano localmente

Verificar o valor de início de ano

Converta a marca de tempo de volta para uma data UTC e confirme que indica 1º de janeiro às 00:00:00 para o ano atual. Se o seu relatório usa um ano fiscal ou um fuso de negócio local, gere um limite separado para essa regra em vez de reutilizar o valor do ano civil UTC. Mantenha a definição escolhida junto à consulta para que os futuros mantenedores saibam por que o limite foi escolhido e qual fuso foi usado.