Edit

Share via

STARTOFMONTH

  • Article

Applies to: Calculated column Calculated table Measure Visual calculation

Note

This function is discouraged for use in visual calculations as it likely returns meaningless results.

Returns the first date of the month in the current context for the specified column of dates.

Syntax

STARTOFMONTH(<dates>)

Parameters

Term Definition
dates A column that contains dates.

Return value

A table containing a single column and single row with a date value.

Remarks

  • The dates argument can be any of the following:

    • A reference to a date/time column.
    • A table expression that returns a single column of date/time values.
    • A Boolean expression that defines a single-column table of date/time values.

  • Constraints on Boolean expressions are described in the topic, CALCULATE.

  • This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

Example

The following sample formula creates a measure that returns the start of the month, for the current context.

= STARTOFMONTH(DateTime[DateKey])

Related content

Date and time functions Time intelligence functions STARTOFYEAR STARTOFQUARTER