La tabla calendario es la dimensión de tiempo del modelo. Sin ella, funciones como "acumulado del año" (YTD) y "mismo período del año anterior" no tienen sobre qué operar. Este tutorial muestra cómo configurarla, incluidos el año fiscal, el calendario 4-4-5 de retail, la zona horaria y el locale pt-BR.
Workspace del ejemplo: Comércio Aurora Ltda (aurora).
Por qué una dimensión de tiempo dedicada#
Una columna de fecha en el hecho sirve para filtrar, pero no sabe qué es un "trimestre",
un "año fiscal" o "la misma semana del año pasado". La dimensión calendario trae esos
atributos listos y es lo que la inteligencia de tiempo usa como eje — consulta
Contexto de fila y de filtro.
Requisitos previos#
- Un modelo con el hecho vinculado a una columna de fecha (consulta Tutorial: modelo estrella).
- Una tabla
calendario(o su generación) con una fila por día del período.
Paso a paso#
Vincula el calendario al hecho
Asegúrate de que exista la relación
vendas.data→calendario.data(N-1, single).Define la zona horaria
Configura la zona horaria del calendario (por defecto
America/Sao_Paulo). El motor trabaja con la fecha civil, no con UTC — una venta a las 22 h del 31/12 queda en el año civil correcto y no se "filtra" al año siguiente.Elige el locale
Selecciona pt-BR para los nombres de mes/día en portugués (la tabla de locale es fija, para garantizar bytes idénticos entre el motor y el SQL).
(Opcional) Año fiscal
Si tu empresa no cierra en diciembre, define el mes de inicio (p. ej., abril). El año fiscal se etiqueta con el año civil en que comienza.
(Opcional) 4-4-5 de retail
Activa el modo 4-4-5 si cierras por semanas (regla "closest"/NRF; la semana 53 va completa al último período).
Valida
Crea un visual "ingresos por período" y verifica el corte de los años/períodos según tu configuración.
Ejemplo: año fiscal que comienza en abril#
Con el año fiscal empezando el 01/04, el año fiscal 2026 cubre 01/04/2026 → 31/03/2027. Un visual "ingresos por año fiscal" agrupa julio/2026 y marzo/2027 en el mismo año fiscal 2026.
Resultado esperado#
- Ejes por año/trimestre/mes/semana disponibles para cualquier medida.
- El YTD y las comparaciones temporales empiezan a funcionar (consulta Tutorial: medidas y comparaciones temporales).
- Una venta el 31/12 a las 22 h (zona horaria de São Paulo) cae en el año/período civil correcto.
Límites y salvedades#
- El locale viene de una tabla fija (no de
Intl), para garantizar bytes idénticos entre el motor puro y el SQL; un idioma nuevo exige una tabla nueva. - Ordenar los meses por número (y no alfabéticamente) usa sort-by-column — consulta Modelo semántico.
Relacionados#
Última revisión: 2026-09-08.