Compartilhar via

FIRSTDATE

  • Artigo

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Nota

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

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

Sintaxe

FIRSTDATE(<dates>)

Parâmetros

Prazo Definição
dates Uma coluna que contém datas.

Valor de retorno

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 booliana que define uma tabela de coluna única de valores de data/hora.

  • Restrições em expressões boolianas são descritas no tópico, CALCULATE função.

  • Quando o contexto atual for 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 valor único. 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.

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

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 da Internet para o contexto atual.

= FIRSTDATE('InternetSales_USD'[SaleDateKey])

Conteúdo relacionado

funções de data e horafunções de inteligência de horaLASTDATE funçãoFIRSTNONBLANK função