DATESINPERIOD DAX Function (Time Intelligence)
Returns the dates from the given period.
Syntax
| Parameter | Attributes | Description |
|---|---|---|
| Dates |
A column reference containing dates. |
|
| StartDate |
Start date. |
|
| NumberOfIntervals |
The number of intervals. |
|
| Interval |
One of: Day, Month, Quarter, Year. |
Return values
A table containing a single column of unique date values.
Notes
In order to use any time intelligence calculation, you need a well-formed date table. The Date table must satisfy the following requirements:
- All dates need to be present for the years required. The Date table must always start on January 1 and end on December 31, including all the days in this range. If the report only references fiscal years, then the date table must include all the dates from the first to the last day of a fiscal year. For example, if the fiscal year 2008 starts on July 1, 2007, then the Date table must include all the days from July 1, 2007 to June 30, 2008.
- There needs to be a column with a DateTime or Date data type containing unique values. This column is usually called Date. Even though the Date column is often used to define relationships with other tables, this is not required. Still, the Date column must contain unique values and should be referenced by the Mark as Date Table feature. In case the column also contains a time part, no time should be used – for example, the time should always be 12:00 am.
- The Date table must be marked as a date table in the model, in case the relationship between the Date table and any other table is not based on the Date.
Remarks
The dates argument must be a reference to a date/time column.
The result table includes only dates that exist in the dates column.
Examples
The following expression evaluates the measure Sales Amount in the last 12 months starting from the last day of the period in the filter context.
Sales Moving Annual Total =
CALCULATE (
[Sales Amount],
DATESINPERIOD (
'Date'[Date],
MAX ( 'Date'[Date] ),
-1,
YEAR
)
)
Related articles
Learn more about DATESINPERIOD in the following articles:
-
Yearly Customer Historical Sales in DAX
With DAX you can calculate the sales of the first, second and third year of a new customer without any ETL. In this article you see how to implement this calculation with good performance. » Read more
Last update: Feb 25, 2021 » Contribute » Show contributors
Contributors: Alberto Ferrari, Marco Russo, Maxim Zelensky
MSDN documentation: https://docs.microsoft.com/en-us/dax/datesinperiod-function-dax