Share via


TOTALYTD Function (DAX)

Evaluates the year-to-date value of the expression in the current context.

Syntax

TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])

Parameters

Parameter

Definition

expression

An expression that returns a scalar value.

dates

A column that contains dates.

filter

(optional) An expression that specifies a filter to apply to the current context.

year_end_date

(optional) A literal string with a date that defines the year-end date. The default is December 31.

Return Value

A scalar value that represents the expression evaluated for the current year-to-date dates.

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 (DAX).

Note

The filter expression has restrictions described in the topic, CALCULATE Function (DAX).

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.

Example

The following sample formula creates a measure that calculates the 'year running total' or 'year running sum' for the Internet sales.

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

Code

=TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])