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 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.
  • 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]))

Time intelligence functions Date and time functions PREVIOUSMONTH PREVIOUSDAY PREVIOUSQUARTER