Partilhar via

FIRSTDATE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Observação

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

Para entrada de coluna de data, retorna a primeira data no contexto atual para a coluna de datas especificada.

Para entrada de calendário, retorna a primeira data no contexto atual com base no calendário.

Sintaxe

FIRSTDATE(<dates> or <calendar>)

Parâmetros

Vigência Definição
dates or calendar Uma coluna que contém datas ou uma referência de calendário

Valor de retorno

Para entrada de coluna de data, uma tabela contendo uma única coluna e uma única linha com um valor de data.

Para entrada de calendário, uma tabela que contém todas as colunas marcadas primárias e todas as colunas relacionadas ao tempo.

Comentários

  • 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, CALCULATE função.

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

  • Para entrada de coluna de data, 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])

Exemplo de inteligência de tempo baseada em calendário

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(FiscalCalendar)

Conteúdo relacionado

Funções de data e horaFunções de inteligência de tempoLASTDATE funçãoFIRSTNONBLANK função

  • Last updated on