Partilhar via


OPENINGBALANCEYEAR

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 data correspondente ao final do ano anterior no contexto atual.

Sintaxe

OPENINGBALANCEYEAR(<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. Aplica-se apenas quando a coluna de data é usada.

Valor de retorno

Um valor escalar que representa o expression avaliado no final do ano anterior 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.

  • A expressão filter tem restrições 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 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 calcula o 'Valor do Inventário de Início do Ano' do estoque de produtos.

=
OPENINGBALANCEYEAR (
    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 Início do Ano' do estoque de produtos em termos de calendário fiscal.

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

OPENINGBALANCEWEEK funçãoOPENINGBALANCEQUARTER funçãoOPENINGBALANCEMONTH funçãoFunçõesCLOSINGBALANCEYEAR de inteligência temporal função