Partilhar via


CLOSINGBALANCEYEAR

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.

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

Sintaxe

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

Parâmetros

Vigência Definição
expression Uma expressão que retorna um valor escalar.
dates or calendar Uma coluna que contém datas ou uma referência de calendário.
filter (facultativo) Uma expressão que especifica um filtro a ser aplicado ao contexto atual.
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

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

Comentários

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

      Observação

      As restrições em expressões booleanas são descritas em CALCULATE função.

      Observação

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

  • 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 calcula o 'Valor de Estoque de Final de Ano' do estoque de produtos.

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

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

A fórmula de exemplo a seguir cria uma medida que calcula o 'Valor de Estoque de Final de Ano' do estoque de produtos usando um calendário fiscal.

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

Funções de inteligência de tempoCLOSINGBALANCEQUARTER funçãoCLOSINGBALANCEMONTH funçãoCLOSINGBALANCEWEEK função