Ano da data.
| Campo | Valor |
|---|---|
| Categoria | Data e tempo |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 1 argumento (fixo) |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: ANO. Aliases aceitos (maiúsc./minúsc. indiferente): year.
Assinatura#
code
ANO(expr)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: YEAR
- Compatibilidade: Compatível com DAX
- Observação: Ano da data.
Exemplos#
code
ANO(pedido_em)Exemplo com valores#
Entrada: data 2025-03-15.
code
ANO(DATA(2025;3;15)) → 2025Resultado esperado: 2025
Exemplo de negócio#
Agrupar o faturamento por ano de competência.
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.