Acumulado do ano até o ponto atual (reinicia no início do ano do calendário do modelo — janeiro no civil, abril num fiscal abr–mar).
| Campo | Valor |
|---|---|
| Categoria | Data e tempo |
| Tipo | Agregação (opera sobre um conjunto de linhas) |
| Aridade | 2 argumentos (fixo) |
| 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: ACUM_ANO. Aliases aceitos (maiúsc./minúsc. indiferente): totalytd, ytd.
Assinatura#
ACUM_ANO(expr; arg2)Todos os argumentos são expressões.
Retorno#
Número (a medida acumulada) ou vazio.
Tratamento de nulos#
Datas inválidas ou ausentes viram erro amigável ou vazio, conforme a função.
Contexto de avaliação#
Inteligência de tempo — descobre a data de referência do grupo e reavalia a medida sobre as linhas do VISUAL (usa allRows) que caem na janela. Vira fiscal/4-4-5 quando o modelo tem esse calendário.
Diferenças para DAX#
- Equivalente DAX: TOTALYTD
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Acumulado do ano SOBRE AS LINHAS DO VISUAL — não exige tabela de datas marcada. Reinicia no início do ano fiscal quando o modelo é fiscal/4-4-5.
Exemplos#
ACUM_ANO(SOMA(receita); dia)Exemplo com valores#
Entrada: grupo março/25; acumulado do ano (50+70+200+150).
ACUM_ANO(SOMA(receita); dia) → 470Resultado esperado: 470
Exemplo de negócio#
Receita acumulada no ano (YTD) na linha do tempo.
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.