PARALLELPERIOD

PARALLELPERIOD is a DAX function that returns a parallel period of dates based on a given set of dates and a specified interval.

Syntax

PARALLELPERIOD(
   Dates,
   NumberOfIntervals,
   Interval
)

Argument	Properties	Description
Dates		The name of a column containing dates or a one column table containing dates.
NumberOfIntervals		The number of the intervals.
Interval		One of: Day, Month, Quarter, Year.

Return Values

A table containing a single column of date values.

Remarks

• This function takes the current set of dates in the column specified by dates, shifts the first date and the last date the specified number of intervals, and then returns all contiguous dates between the two shifted dates. If the interval is a partial range of month, quarter, or year then any partial months in the result are also filled out to complete the entire interval.

• 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 function.

• If the number specified for number_of_intervals is positive, the dates in dates are moved forward in time; if the number is negative, the dates in dates are shifted back in time.

• The interval parameter is an enumeration, not a set of strings; therefore values should not be enclosed in quotation marks. Also, the values: year, quarter, month should be spelled in full when using them.

• The result table includes only dates that appear in the values of the underlying table column.

• The PARALLELPERIOD function is similar to the DATEADD function except that PARALLELPERIOD always returns full periods at the given granularity level instead of the partial periods that DATEADD returns. For example, if you have a selection of dates that starts at June 10 and finishes at June 21 of the same year, and you want to shift that selection forward by one month then the PARALLELPERIOD function will return all dates from the next month (July 1 to July 31); however, if DATEADD is used instead, then the result will include only dates from July 10 to July 21.

• This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

The following sample formula creates a measure that calculates the previous year sales for Internet sales.

= CALCULATE(SUM(InternetSales_USD[SalesAmount_USD]), PARALLELPERIOD(DateTime[DateKey],-1,year))

Related functions

Other functions related to PARALLELPERIOD are:

• DATEADD

Contribute » | Contributors: Rick de Groot
Microsoft documentation: https://learn.microsoft.com/en-us/dax/parallelperiod-function-dax