A tabela calendário é a dimensão de tempo do modelo. Sem ela, funções como "acumulado no ano" (YTD) e "mesmo período do ano anterior" não têm sobre o que operar. Este tutorial mostra como configurá-la, inclusive ano fiscal, calendário 4-4-5 de varejo, fuso e locale pt-BR.
Workspace do exemplo: Comércio Aurora Ltda (aurora).
Maturidade
Os calendários configuráveis estão em Preview. O motor (motor puro em TS) é coberto por suíte determinística, mas a equivalência TS ↔ SQL do datalake real nunca foi medida — por isso o estado é Preview, e não GA-candidato.
Por que uma dimensão de tempo dedicada#
Uma coluna de data no fato serve para filtrar, mas não sabe o que é "trimestre",
"ano fiscal" ou "mesma semana do ano passado". A dimensão calendario traz esses
atributos prontos e é o que a inteligência de tempo usa como eixo — ver
Contexto de linha e de filtro.
Pré-requisitos#
- Um modelo com o fato ligado a uma coluna de data (ver Tutorial: modelo estrela).
- Uma tabela
calendario(ou a geração dela) com uma linha por dia do período.
Passo a passo#
Ligue o calendário ao fato
Garanta a relação
vendas.data→calendario.data(N-1, single).Defina o fuso
Configure o fuso do calendário (padrão
America/Sao_Paulo). O motor trabalha com data civil, não UTC — uma venda às 22h de 31/12 fica no ano civil correto, não "vaza" para o ano seguinte.Escolha o locale
Selecione pt-BR para nomes de mês/dia em português (a tabela de locale é fixa, para garantir bytes idênticos entre motor e SQL).
(Opcional) Ano fiscal
Se sua empresa não fecha em dezembro, defina o mês de início (ex.: abril). O ano fiscal é rotulado pelo ano civil em que começa.
(Opcional) 4-4-5 de varejo
Ative o modo 4-4-5 se você fecha em semanas (regra "closest"/NRF; a 53ª semana vai inteira para o último período).
Valide
Crie um visual "receita por período" e confira o corte dos anos/períodos conforme sua configuração.
Exemplo: ano fiscal iniciando em abril#
Com ano fiscal começando em 01/04, o ano fiscal 2026 cobre 01/04/2026 → 31/03/2027. Um visual "receita por ano fiscal" agrupa julho/2026 e março/2027 no mesmo ano fiscal 2026.
Resultado esperado#
- Eixos por ano/trimestre/mês/semana disponíveis para qualquer medida.
- YTD e comparações temporais passam a funcionar (ver Tutorial: medidas e comparações temporais).
- Uma venda em 31/12 às 22h (fuso de São Paulo) cai no ano/período civil correto.
Limites e ressalvas#
- Locale vem de tabela fixa (não de
Intl), para garantir bytes idênticos entre o motor puro e o SQL; um novo idioma exige nova tabela. - A equivalência exata motor ↔ datalake real depende de execução em nuvem (
NÃO MEDIDO); por isso a capacidade é Preview. - Ordenar meses pelo número (e não alfabeticamente) usa sort-by-column — ver Modelo semântico.
Relacionados#
Última revisão: 2026-09-08.