Year-to-date up to the current point (restarts at the beginning of the year of the model's calendar — January in the calendar year, April in an Apr–Mar fiscal year).
| Field | Value |
|---|---|
| Category | Date and time |
| Type | Aggregation (operates on a set of rows) |
| Arity | 2 arguments (fixed) |
| Compiles to SQL (calculated column) | No |
| Version | Formula engine v3, with fiscal/4-4-5 calendar support. |
Aliases#
Canonical name: ACUM_ANO. Accepted aliases (case-insensitive): totalytd, ytd.
Syntax#
ACUM_ANO(expr; arg2)All arguments are expressions.
Returns#
Number (the accumulated measure) or blank.
Null handling#
Invalid or missing dates become a friendly error or blank, depending on the function.
Evaluation context#
Time intelligence — finds the group's reference date and re-evaluates the measure over the VISUAL's rows (uses allRows) that fall within the window. Switches to fiscal/4-4-5 when the model has that calendar.
Differences from DAX#
- DAX equivalent: TOTALYTD
- Compatibility: DIFFERS from DAX — different semantics, watch out
- Note: Year-to-date OVER THE VISUAL'S ROWS — no marked date table required. Restarts at the beginning of the fiscal year when the model is fiscal/4-4-5.
Examples#
ACUM_ANO(SOMA(receita); dia)Example with values#
Input: group March/25; year-to-date (50+70+200+150).
ACUM_ANO(SOMA(receita); dia) → 470Expected result: 470
Business example#
Revenue accumulated over the year (YTD) on the timeline.
Common errors#
Typos in a column name, an incompatible type, or an invalid argument become a friendly message (pt-BR) — the engine never silently returns a wrong number.