Partilhar via


PRIMEIRA DATA

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.

Devolve a primeira data no contexto atual para a coluna de datas especificada.

Sintaxe

FIRSTDATE(<dates>)  

Parâmetros

Termo Definição
Datas Uma coluna que contém datas.

Valor devolvido

Uma tabela que contém uma única coluna e uma única linha com um valor de data.

Observações

  • O argumento dates pode ser qualquer um dos seguintes:

    • Uma referência a uma coluna de data/hora.
    • Uma expressão de tabela que retorna uma única coluna de valores de data/hora.
    • Uma expressão booleana que define uma tabela de coluna única de valores de data/hora.
  • Restrições em expressões booleanas são descritas no tópico, função CALCULATE.

  • Quando o contexto atual é uma única data, a data retornada pelas funções FIRSTDATE e LASTDATE será igual.

  • O valor Return é uma tabela que contém uma única coluna e um único valor. Portanto, essa função pode ser usada como um argumento para qualquer função que exija uma tabela em seus argumentos. Além disso, o valor retornado pode ser usado sempre que um valor de data for necessário.

  • 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 fórmula de exemplo a seguir cria uma medida que obtém a primeira data em que uma venda foi feita no canal de vendas pela Internet para o contexto atual.

= FIRSTDATE('InternetSales_USD'[SaleDateKey])  

Funções de data e hora
Funções de inteligência de tempo
Função LASTDATE
Função FIRSTNONBLANK