PREVIOUSYEAR Function
Returns a table that contains a column of all dates from the previous year, given the last date in the dates column, in the current context.
Syntax
PREVIOUSYEAR(<dates>[,<year_end_date>])
Parameters
Term |
Definition |
dates |
A column containing 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
Note
To understand more about how context affects the results of formulas, see Context in DAX Formulas.
This function returns all dates from the previous year given the latest date in the input parameter. For example, if the latest date in the dates argument refers to the year 2009, then this function returns all dates for the year of 2008, up to the specified year_end_date.
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 previous year sales 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 Previous Year Sales, using the formula defined in the code section, to the Values area of the PivotTable.
=CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PREVIOUSYEAR('DateTime'[DateKey]))