Partilhar via


ENDOFYEAR

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Observação

Esta função é desencorajada para uso em cálculos visuais pois provavelmente retorna resultados sem sentido.

Para entrada de coluna de data, retorna a última data do ano no contexto atual para a coluna de datas especificada.
Para entrada de calendário, retorna uma tabela que contém todas as colunas marcadas primárias e todas as colunas relacionadas ao tempo para a última data do ano, no contexto atual.

Sintaxe

ENDOFYEAR(<dates> or <calendar> [,<year_end_date>])

Parâmetros

Vigência Definição
dates or calendar Uma coluna que contém datas ou uma referência de calendário
year_end_date (facultativo) Uma cadeia de caracteres literal com uma data que define a data de fim de ano. O padrão é 31 de dezembro. Este parâmetro só é permitido quando a sintaxe da coluna de data é usada.

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 que contém todas as colunas marcadas primárias e todas as colunas relacionadas ao tempo para a última data do ano, no contexto atual.

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 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, CALCULATE função.

  • O parâmetro year_end_date é um literal de cadeia de caracteres de uma data, na mesma localidade que a localidade do cliente onde a pasta de trabalho foi criada. A parte do ano da data é ignorada.

  • O year_end_date parâmetro é permitido somente quando a sintaxe da coluna de data é usada.

  • 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 final do ano fiscal que termina em 30 de junho, para o contexto atual.

= ENDOFYEAR(DateTime[DateKey],"06/30/2004")

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

A fórmula de exemplo a seguir retorna colunas primárias marcadas que correspondem ao final do ano, para o calendário fiscal.

= ENDOFYEAR(FiscalCalendar)

Funções de data e horaFunções de inteligência de tempofunçãoENDOFWEEK funçãoENDOFMONTHENDOFQUARTER