STARTOFYEAR
Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual
Observação
Essa função não é recomendada para uso em cálculos visuais, pois é provável que ela retorne resultados sem sentido.
Retorna a primeira data do ano no contexto atual para a coluna de datas especificada.
Sintaxe
STARTOFYEAR(<dates>)
Parâmetros
Termo | Definição |
---|---|
datas | Uma coluna que contém datas. |
YearEndDate | (Opcional) Um valor de data de término do ano. |
Valor retornado
Uma tabela que contém uma única coluna e uma única linha com um valor de data.
Comentários
O argumento dates pode ser 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.
As restrições em expressões boolianas são descritas no tópico CALCULATE.
Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.
Exemplo
O exemplo de fórmula a seguir cria uma medida que retorna o início do ano para o contexto atual.
= STARTOFYEAR(DateTime[DateKey])
Conteúdo relacionado
Funções de data e hora
Funções de inteligência de dados temporais
STARTOFQUARTER
STARTOFMONTH