PRIMEIRA DATA
Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual
Nota
Esta função é desencorajada para uso em cálculos visuais, pois provavelmente retorna resultados sem sentido.
Devolve 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 devolvido
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 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, função CALCULATE.
Quando o contexto atual é 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 ú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])
Conteúdos relacionados
Funções de data e hora
Funções de inteligência de tempo
Função LASTDATE
Função FIRSTNONBLANK