DATESYTD

Returns a table that contains a column of the dates for the year to date, in the current context.

Syntax

DATESYTD(<dates> [,<year_end_date>])  

Parameters

Term Definition
dates A column that contains dates.
year_end_date (optional) A literal string with a date that defines the year-end date. The default is December 31.

Return value

A table containing a single column of date values.

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.

    Note

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

  • The year_end_date parameter is a string literal of a date, in the same locale as the locale of the client where the workbook was created. The year portion of the date is ignored.

  • 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 calculates the 'Running Total' for Internet sales.

= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), DATESYTD(DateTime[DateKey]))  

See also

Time intelligence functions
Date and time functions
DATESMTD function
DATESQTD function