Compartilhar via


CLOSINGBALANCEYEAR

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Nota

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

Avalia o expression na última data do ano no contexto atual.

Sintaxe

CLOSINGBALANCEYEAR(<expression>,<dates>[,<filter>][,<year_end_date>])

Parâmetros

Prazo Definição
expression Uma expressão que retorna um valor escalar.
dates Uma coluna que contém datas.
filter (opcional) Uma expressão que especifica um filtro a ser aplicado ao contexto atual.
year_end_date (opcional) Uma cadeia de caracteres literal com uma data que define a data de término do ano. O padrão é 31 de dezembro.

Valor de retorno

Um valor escalar que representa o expression avaliado na última data do ano no contexto atual.

Observações

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

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

      Nota

      Restrições em expressões boolianas são descritas em CALCULATE função.

      Nota

      A expressão filter tem restrições descritas em CALCULATE função.

  • 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 calcula o "Valor de Inventário de Fim de Ano" do inventário do produto.

= CLOSINGBALANCEYEAR(SUMX(ProductInventory,ProductInventory[UnitCost]*ProductInventory[UnitsBalance]),DateTime[DateKey])

funções de inteligência de tempoCLOSINGBALANCEYEAR funçãoCLOSINGBALANCEQUARTER funçãoCLOSINGBALANCEMONTH função