Skip to content

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

INICIO_MES

On this page (10)

1st day of the month (period, in the fiscal/4-4-5 calendar) of the current group.

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

Aliases#

Canonical name: INICIO_MES. Accepted aliases (case-insensitive): startofmonth.

Syntax#

code
INICIO_MES(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: STARTOFMONTH
  • Compatibility: DIFFERS from DAX — different semantics, watch out
  • Note: Returns the date (scalar) of the 1st day of the group's month/fiscal period; DAX STARTOFMONTH returns a table.

Examples#

code
INICIO_MES(dia)

Example with values#

Input: group for March/25.

code
INICIO_MES(dia)  →  2025-03-01

Expected result: 2025-03-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.


← Back to the formula index

Related links