Edit

Share via

CLOSINGBALANCEYEAR

Applies to: Calculated column Calculated table Measure Visual calculation

Note

This function is discouraged for use in visual calculations as it likely returns meaningless results.

Evaluates the expression at the last date of the year in the current context.

Syntax

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

Parameters

Term Definition
expression An expression that returns a scalar value.
dates or calendar A column that contains dates or a calendar reference.
filter (optional) An expression that specifies a filter to apply to the current context.
year_end_date (optional) A literal string with a date that defines the year-end date. The default is December 31. This parameter is permitted only when the date column syntax is used.

Return value

A scalar value that represents the expression evaluated at the last date of the year in the current context.

Remarks

  • The year_end_date parameter is a string literal of a date, in the same locale as the locale of the client where the workbook was created. The year portion of the date is ignored.

  • The dates argument can be any of the following:

    • A reference to a date/time column.

    • A table expression that returns a single column of date/time values.

    • A Boolean expression that defines a single-column table of date/time values.

      Note

      Constraints on Boolean expressions are described in CALCULATE function.

      Note

      The filter expression has restrictions described in CALCULATE function.

  • The year_end_date parameter is permitted only when the date column syntax is used.

  • This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

Example

The following sample formula creates a measure that calculates the 'Year End Inventory Value' of the product inventory.

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

Example for calendar based time intelligence

The following sample formula creates a measure that calculates the 'Year End Inventory Value' of the product inventory using a fiscal calendar.

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

Related content

Time intelligence functions CLOSINGBALANCEQUARTER function CLOSINGBALANCEMONTH function CLOSINGBALANCEWEEK function