Compartilhar via

  • Artigo

Função FIRSTDATE (DAX)

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

Sintaxe

FIRSTDATE(<dates>)

Parâmetros

Termo

Definição

dates

Uma coluna que contém datas.

Valor de retorno

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

Comentários

ObservaçãoObservação

Para entender melhor como o contexto afeta os resultados das fórmulas, consulte Contexto em fórmulas DAX.

O argumento dates pode ser qualquer um destes:

  • 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 com uma única coluna de valores de data/hora.

ObservaçãoObservação

As restrições em expressões boolianas são descritas no tópico Função CALCULATE (DAX).

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

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

Exemplo

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

Para ver como isso funciona, crie uma Tabela Dinâmica e adicione o campo CalendarYear à área Rótulos de Linha da Tabela Dinâmica. Em seguida, adicione uma medida denominada FirstSaleDate, usando a fórmula definida na seção de código, à área Valores da Tabela Dinâmica.

=FIRSTDATE('InternetSales_USD'[SaleDateKey])