Partilhar via

DATAENTRE

  • Artigo

Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual

Nota

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

Retorna uma tabela que contém uma coluna de datas que começa com uma data de início especificada e continua até uma data de término especificada.

Esta função é adequada para passar como um filtro para a função CALCULATE . Use-o para filtrar uma expressão por um intervalo de datas personalizado.

Nota

Se você estiver trabalhando com intervalos de data padrão, como dias, meses, trimestres ou anos, é recomendável usar a função DATESINPERIOD mais adequada.

Sintaxe

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

Parâmetros

Termo Definição
Dates Uma coluna de data.
StartDate Uma expressão de data.
EndDate Uma expressão de data.

Valor devolvido

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

Observações

  • No caso de uso mais comum, Datas é uma referência à coluna de data de uma tabela de datas marcada.

  • Se StartDate for BLANK, StartDate será o valor mais antigo na coluna Dates.

  • Se EndDate estiver em BRANCO, EndDate será o valor mais recente na coluna Datas.

  • As datas usadas como StartDate e EndDate são inclusivas. Assim, por exemplo, se o valor StartDate for 1 de julho de 2019, essa data será incluída na tabela devolvida (desde que a data exista na coluna Datas ).

  • A tabela retornada só pode conter datas armazenadas na coluna Datas . Assim, por exemplo, se a coluna Datas começar a partir de 1º de julho de 2017 e o valor StartDate for 1º de julho de 2016, a tabela retornada começará a partir de 1º de julho de 2017.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

A definição de medida da tabela Sales a seguir usa a função DATESBETWEEN para produzir um cálculo de vida até a data (LTD). A vida até à data representa a acumulação de uma medida ao longo do tempo desde o início dos tempos.

Observe que a fórmula usa a função MAX . Esta função retorna a data mais recente que está no contexto do filtro. Assim, a função DATESBETWEEN retorna uma tabela de datas que começam desde a data mais antiga até a data mais recente que está sendo relatada.

Exemplos neste artigo podem ser usados com o modelo de exemplo do Power BI Desktop do Adventure Works DW 2020. Para obter o modelo, consulte Modelo de exemplo DAX.

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

Considere que a data mais antiga armazenada na tabela Data é 1º de julho de 2017. Assim, quando um relatório filtra a medida até o mês de junho de 2020, a função DATESBETWEEN retorna um intervalo de datas de 1º de julho de 2017 a 30 de junho de 2020.

Conteúdos relacionados