Diferença entre duas datas na unidade escolhida.
| Campo | Valor |
|---|---|
| Categoria | Data e tempo |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 3 argumentos (fixo) |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: DATADIF. Aliases aceitos (maiúsc./minúsc. indiferente): datediff.
Assinatura#
code
DATADIF(expr; arg2; arg3)Todos os argumentos são expressões.
Retorno#
Número.
Tratamento de nulos#
Datas inválidas ou ausentes viram erro amigável ou vazio, conforme a função.
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: DATEDIFF
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Só as unidades DIA, MES e ANO — o DATEDIFF do DAX tem SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER e YEAR.
Exemplos#
code
DATADIF(pedido_em; entregue_em; "DIA")Exemplo com valores#
Entrada: de 2025-01-01 a 2025-03-31, em dias.
code
DATADIF("2025-01-01"; "2025-03-31"; "DIA") → 89Resultado esperado: 89
Exemplo de negócio#
Prazo de entrega em dias, do pedido à entrega.
Erros comuns#
DATADIF: unidade deve ser "DIA", "MES" ou "ANO" · DATADIF: "…" não é uma data.