STARTOFYEAR

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Para entrada de coluna de data, retorna a primeira data do ano no contexto atual para a coluna de datas especificada.
Para entrada de calendário, retorna uma tabela para a primeira data do ano, no contexto atual. A tabela contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos.

Sintaxe

STARTOFYEAR(<dates> or <calendar>)

Parâmetros

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 para a primeira data do ano, no contexto atual. A tabela contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos.

Comentários

• 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.

• O year_end_date parâmetro não deve ser especificado quando um calendário é usado.

• 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 retorna o início do ano para o contexto atual.

= STARTOFYEAR(DateTime[DateKey])

Exemplo de inteligência de tempo baseada em calendário

A fórmula de exemplo a seguir cria uma tabela que retorna colunas marcadas que correspondem ao início do ano, para o calendário fiscal.

= STARTOFYEAR(FiscalCalendar)

Conteúdo relacionado

Funções de data e horafunções de inteligência de tempoSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK