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> or <calendar>[,<filter>][,<year_end_date>])

Parâmetros

Prazo 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 (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. Esse 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.

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.

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

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

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 Inventário de Fim de Ano" do inventário do produto usando um calendário fiscal.

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

Conteúdo relacionado

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

  • Last updated on