1st day of the year (fiscal, when configured) of the current group.
| Field | Value |
|---|---|
| Category | Date and time |
| Type | Aggregation (operates on a set of rows) |
| Arity | 1 argument (fixed) |
| Compiles to SQL (calculated column) | No |
| Version | Formula engine v3, with fiscal/4-4-5 calendar support. |
Aliases#
Canonical name: INICIO_ANO. Accepted aliases (case-insensitive): startofyear.
Syntax#
code
INICIO_ANO(coluna)The 1st argument is the name of a column (bare identifier); the others are expressions.
Returns#
Date.
Null handling#
Invalid or missing dates become a friendly error or blank, depending on the function.
Evaluation context#
Aggregation — goes through the rows of the visual's current group.
Differences from DAX#
- DAX equivalent: STARTOFYEAR
- Compatibility: DIFFERS from DAX — different semantics, watch out
- Note: Returns the date (scalar) of the 1st day of the year (fiscal when configured); DAX STARTOFYEAR returns a table.
Examples#
code
INICIO_ANO(dia)Example with values#
Input: group for 2025.
code
INICIO_ANO(dia) → 2025-01-01Expected result: 2025-01-01
Business example#
Time analysis — order age, accrual month/year, accounting close.
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.