Compartilhar via

FIRSTDATE

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.

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

Prazo 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 que contém 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 colunas relacionadas a todos os tempos.

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.

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

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

= FIRSTDATE(FiscalCalendar)

Conteúdo relacionado

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

  • Last updated on