Partilhar via

DATESBETWEEN

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMeasureCálculo visual

Observação

Esta 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 um início especificado dateand continua até um final especificado date.

Esta função é adequada para passar como um filter para a função CALCULATE. Use-o 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 usar a função DATESINPERIOD mais adequada.

Sintaxe

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

Parâmetros

Vigência Definição
Dates Uma coluna date.
StartDate Uma expressão date.
EndDate Uma expressão date.

Regresso value

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

Comentários

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

  • If StartDate for BLANK, StartDate será o earliestvalue na coluna dates.

  • If EndDate for BLANK, EndDate será a value mais recente na coluna dates.

  • As datas utilizadas como StartDateandEndDate estão incluídas. Assim, por exemplo, if o StartDatevalue for 1º de julho de 2019, 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. Assim, por exemplo, if a coluna Dates começar 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.

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

Exemplo

A seguinte tabela de vendas measure definição usa a função DATESBETWEEN para produzir um cálculo de vida paradate (LTD). A vida-para-date representa a acumulação de um measure ao longo de 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. Assim, a função DATESBETWEEN retorna uma tabela de datas que começam a partir do earliestdate até o último date sendo relatado.

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. Assim, 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.

Related conteúdo