Data de hoje.
| Campo | Valor |
|---|---|
| Categoria | Data e tempo |
| Tipo | Escalar (opera valor a valor) |
| Aridade | sem argumentos |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: HOJE. Aliases aceitos (maiúsc./minúsc. indiferente): today.
Assinatura#
code
HOJE()Todos os argumentos são expressões.
Retorno#
Data.
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: TODAY
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Usa o fuso America/Sao_Paulo; o TODAY do DAX usa o fuso do serviço (tipicamente UTC).
Exemplos#
code
DATADIF(pedido_em; HOJE(); "DIA")Exemplo com valores#
Entrada: chamada sem argumentos (data do dia, fuso America/Sao_Paulo).
code
HOJE() → 2025-03-15Resultado esperado: 2025-03-15
NÃO determinístico — muda a cada dia; aqui fixamos 2025-03-15 só para ilustrar.
Exemplo de negócio#
Análise temporal — idade do pedido, mês/ano de competência, fechamento contábil.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.