Ler em inglês

Compartilhar via


DATESBETWEEN

aplica-se a:coluna calculadatabela calculadaMeasurecálculo visual

Observação

Essa função é desencorajada para uso em cálculos visuais pois provavelmente retorna resultados sem sentido.

Retorna uma tabela que contains uma coluna de datas que começa com uma dateand de início especificada continua até um datefinal especificado.

Essa função é adequada para passar como um filter para a função CALCULATE. Use-a para filter uma expressão por um daterangepersonalizado.

Observação

If você estiver trabalhando com intervalos de date padrão, como dias, meses, trimestres or anos, é recomendável que você use a função DATESINPERIOD mais adequada.

Sintaxe

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

Parâmetros

Prazo Definição
Dates Uma coluna date.
StartDate Uma expressão date.
EndDate Uma expressão date.

Retornar value

Uma tabela que contém uma única coluna de datevalues.

Observações

  • No caso de uso mais comum, dates é uma referência à coluna date de uma tabela de date marcada.

  • If StartDate é BLANK, então StartDate será o earliestvalue na coluna dates.

  • If EndDate é BLANK, então EndDate será o value mais recente na coluna dates.

  • As datas usadas como StartDateandEndDate são inclusivas. Portanto, por exemplo, if o StartDatevalue for 1º de julho de 2019, então esse date será incluído na tabela retornada (desde que o date exista na coluna dates).

  • A tabela retornada só pode conter datas armazenadas na coluna Dates. Portanto, por exemplo, if a coluna Dates começa a partir de 1º de julho de 2017, and o StartDatevalue for 1º de julho de 2016, a tabela retornada começará a partir de 1º de julho de 2017.

  • Essa função not tem suporte para uso no modo DirectQuery quando usada em colunas calculadas or regras de RLS (segurança em nível de linha).

Exemplo

A seguinte definição da tabela Sales usa a função para produzir um cálculo de (LTD) . A vida adate representa o acúmulo de uma measure sobre time desde o início de time.

Observe que a fórmula usa a função MAX. Essa função retorna o date mais recente que está no contexto filter. Portanto, a função DATESBETWEEN retorna uma tabela de datas começando do earliestdate até que a última date seja relatada.

Exemplos neste artigo podem ser usados com o modelo sample Adventure Works DW 2020 Power BI Desktop. Para obter o modelo, consulte DAXsample modelo.

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

Considere que o earliestdate armazenado na tabela Date é 1º de julho de 2017. Portanto, quando um relatório filters o measure até o month de junho de 2020, a função DATESBETWEEN retorna um daterange de 1º de julho de 2017 até 30 de junho de 2020.