DATESYTD Function

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.

Property Value/Return Value

A table containing a single column of date values.

Remarks

Note

To understand more about how context affects the results of formulas, see Context in DAX Formulas.

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 DAX function is not supported for use in DirectQuery mode. For more information about limitations in DirectQuery models, see  https://go.microsoft.com/fwlink/?LinkId=219172.

Example

The following sample formula creates a measure that calculates the 'Running Total' for the Internet sales.

To see how this works, create a PivotTable and add the fields, CalendarYear and CalendarQuarter, to the Row Labels area of the PivotTable. Then add a measure named Running Total, using the formula defined in the code section, to the Values area of the PivotTable.

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

See Also

Reference

DATESMTD Function

DATESQTD Function

Other Resources

Time Intelligence Functions (DAX)

Date and Time Functions (DAX)

Get Sample Data