FIRSTDATE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Observação

Essa função não é recomendada para uso em cálculos visuais, pois é provável que ela retorne resultados sem sentido.

Retorna 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 retornado

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

Comentários

• O argumento dates pode ser 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 booliana que define uma tabela de coluna única de valores de data/hora.

• As restrições em expressões boolianas 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á a mesma.

• O Valor retornado é 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 é necessário.

• Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo

A fórmula de exemplo a seguir cria uma medida que obtém a primeira data de quando uma venda foi feita no canal de vendas pela Internet para o contexto atual.

= FIRSTDATE('InternetSales_USD'[SaleDateKey])  

Conteúdo relacionado

Funções de data e hora
Funções de inteligência de dados temporais
função LASTDATE
Função FIRSTNONBLANK