Compartilhar via


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])  

Funções de data e hora
Funções de inteligência de dados temporais
STARTOFQUARTER
STARTOFMONTH