PREVIOUSYEAR
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 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
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 specifiedyear_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.
Constraints on Boolean expressions are described in the topic, CALCULATE.
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 previous year sales for Internet sales.
= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PREVIOUSYEAR('DateTime'[DateKey]))
Related content
Time intelligence functions Date and time functions PREVIOUSMONTH PREVIOUSDAY PREVIOUSQUARTER