CLOSINGBALANCEYEAR

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Note

Cette fonction est déconseillée pour une utilisation dans calculs visuels car elle retourne probablement des résultats sans signification.

Évalue les expression à la dernière date de l’année dans le contexte actuel.

Syntaxe

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

Paramètres

Terme	Définition
expression	Expression qui retourne une valeur scalaire.
dates or calendar	Colonne qui contient des dates ou une référence de calendrier.
filter	(facultatif) Expression qui spécifie un filtre à appliquer au contexte actuel.
year_end_date	(facultatif) Chaîne littérale avec une date qui définit la date de fin d’année. La valeur par défaut est le 31 décembre. Ce paramètre n’est autorisé que lorsque la syntaxe de colonne de date est utilisée.

Valeur de retour

Valeur scalaire qui représente l'expression évaluée à la dernière date de l’année dans le contexte actuel.

Remarques

• Le paramètre year_end_date est un littéral de chaîne d’une date, dans les mêmes paramètres régionaux que les paramètres régionaux du client où le classeur a été créé. La partie année de la date est ignorée.

• L’argument dates peut être l’un des éléments suivants :

  • Référence à une colonne de date/heure.

  • Expression de table qui retourne une seule colonne de valeurs de date/heure.

  • Expression booléenne qui définit une table à colonne unique de valeurs de date/heure.

    Note

    Les contraintes sur les expressions booléennes sont décrites dans CALCULATE fonction.

    Note

    L’expression filter a des restrictions décrites dans CALCULATE fonction.

• Le year_end_date paramètre est autorisé uniquement lorsque la syntaxe de colonne de date est utilisée.

• Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).

Exemple

L’exemple de formule suivant crée une mesure qui calcule la « valeur d’inventaire de fin d’année » de l’inventaire des produits.

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

Exemple pour l’intelligence temporelle basée sur le calendrier

L’exemple de formule suivant crée une mesure qui calcule la « valeur d’inventaire de fin d’année » de l’inventaire des produits à l’aide d’un calendrier fiscal.

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

Contenu connexe

fonctions Time IntelligenceCLOSINGBALANCEQUARTER fonctionCLOSINGBALANCEMONTH fonctionCLOSINGBALANCEWEEK fonction