DATEBETWEEN

Применяется к:вычисляемой таблице вычисляемой таблицы Вычисление визуального элемента измерениявычисляемой таблицы

Примечание.

Эта функция не рекомендуется использовать в визуальных вычислениях , так как, скорее всего, возвращает бессмысленные результаты.

Возвращает таблицу, содержащую столбец дат, начинающихся с указанной даты начала и продолжающейся до указанной даты окончания.

Эта функция подходит для передачи в качестве фильтра функции CALCULATE . Используйте его для фильтрации выражения по пользовательскому диапазону дат.

Примечание.

Если вы работаете со стандартными интервалами дат, такими как дни, месяцы, кварталы или годы, рекомендуется использовать более подходящую функцию DATESINPERIOD.

Синтаксис

DATESBETWEEN(<Dates>, <StartDate>, <EndDate>)

Параметры

Термин Определение
Даты Столбец даты.
StartDate Выражение даты.
EndDate Выражение даты.

Возвращаемое значение

Таблица, содержащая один столбец значений даты.

Замечания

  • В наиболее распространенном варианте использования Dates является ссылкой на столбец дат помеченной таблицы дат.

  • Если значение StartDate равно BLANK, StartDate будет самым ранним значением в столбце Dates.

  • Если значение EndDate равно BLANK, EndDate будет самым поздним значением в столбце Dates.

  • Даты, используемые в параметрах StartDate и EndDate, являются включающими. Например, если значение StartDate равно 1 июля 2019 г, то эта дата будет включена в возвращаемую таблицу (предоставляя дату в столбце Dates).

  • Возвращаемая таблица может содержать только даты, хранящиеся в столбце Dates. Например, если столбец Dates начинается с 1 июля 2017 г., а значение StartDate равно 1 июля 2016 г., то возвращаемая таблица будет начинаться с 1 июля 2017 г.

  • Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).

Пример

В приведенном ниже определении меры "Продажи" используется функция DATEBETWEEN для создания вычисления времени до даты (LTD). Срок жизни представляет собой накопление меры с течением времени с самого начала времени.

Обратите внимание, что формула использует функцию MAX . Эта функция возвращает последнюю дату, которая находится в контексте фильтра. Таким образом, функция DATEBETWEEN возвращает таблицу дат, начиная с самой ранней даты до последней даты.

Примеры в этой статье можно использовать с примером модели Adventure Works DW 2020 Power BI Desktop. Чтобы получить модель, воспользуйтесь образцом модели DAX.

Customers LTD =
CALCULATE(
    DISTINCTCOUNT(Sales[CustomerKey]),
    DATESBETWEEN(
        'Date'[Date],  
        BLANK(),  
        MAX('Date'[Date])  
    )
)

Рассмотрим, что самая ранняя дата, хранящуюся в таблице дат , — 1 июля 2017 года. Таким образом, когда отчет фильтрует меру на месяц 2020 года, функция DATEBETWEEN возвращает диапазон дат с 1 июля 2017 г. до 30 июня 2020 г.