Partilhar via

STARTOFYEAR

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Nota

Esta 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 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 todas as colunas relacionadas ao tempo.

Sintaxe

STARTOFYEAR(<dates> or <calendar>)

Parâmetros

Termo Definição
dates or calendar Uma coluna que contém datas ou uma referência de calendário.
YearEndDate (Opcional) Um valor de data de fim de ano. Aplica-se apenas à entrada da coluna de data.

Valor de retorno

Para entrada de coluna de data, uma tabela contendo 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 todas as colunas relacionadas ao tempo.

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.

  • As restrições nas expressões booleanas são descritas no tópico CALCULATE.

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

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

  • Last updated on