Dentro de CALCULAR: janela de N períodos a partir da data informada (N negativo volta no tempo). É o acumulado móvel — 3 meses, 12 meses, 7 dias.
| Campo | Valor |
|---|---|
| Categoria | Data e tempo |
| Tipo | Agregação (opera sobre um conjunto de linhas) |
| Aridade | 3 a 4 argumentos |
| Compila para SQL (coluna calculada) | Não |
| Versão | Motor de fórmulas v3, com suporte a calendário fiscal/4-4-5. |
Aliases#
Nome canônico: DATAS_NO_PERIODO. Aliases aceitos (maiúsc./minúsc. indiferente): datesinperiod.
Assinatura#
DATAS_NO_PERIODO(coluna; arg2; arg3; [arg4])O 1º argumento é o nome de uma coluna (identificador nu); os demais são expressões.
Retorno#
Modificador de CALCULAR (redefine a janela de datas).
Tratamento de nulos#
Datas inválidas ou ausentes viram erro amigável ou vazio, conforme a função.
Contexto de avaliação#
Modificador — só faz sentido DENTRO de CALCULAR (ou de outra função de contexto que o aceite). Fora daí, avisa em vez de devolver número errado.
Diferenças para DAX#
- Equivalente DAX: DATESINPERIOD
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Janela de N períodos a partir de uma data, usada dentro de CALCULAR; opera sobre as linhas do visual.
Exemplos#
CALCULAR(SOMA(receita); DATAS_NO_PERIODO(dia; ULTIMA_DATA(dia); -3; "MES"))Exemplo com valores#
Entrada: últimos 3 meses até a última data do grupo.
CALCULAR(SOMA(receita); DATAS_NO_PERIODO(dia; ULTIMA_DATA(dia); -3; "MES")) → 470Resultado esperado: 470
Exemplo de negócio#
Análise temporal — idade do pedido, mês/ano de competência, fechamento contábil.
Erros comuns#
Unidade inválida vira erro guiado ("DIA", "MES", "TRI" ou "ANO").