Skip to content

Automatic translation — the Portuguese version is the reference. View in Portuguese

ACUM_ANO

On this page (10)

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).

FieldValue
CategoryDate and time
TypeAggregation (operates on a set of rows)
Arity2 arguments (fixed)
Compiles to SQL (calculated column)No
VersionFormula engine v3, with fiscal/4-4-5 calendar support.

Aliases#

Canonical name: ACUM_ANO. Accepted aliases (case-insensitive): totalytd, ytd.

Syntax#

code
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#

code
ACUM_ANO(SOMA(receita); dia)

Example with values#

Input: group March/25; year-to-date (50+70+200+150).

code
ACUM_ANO(SOMA(receita); dia)  →  470

Expected 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.


← Back to the formula index

Related links