Partage via

TOTALYTD

  • Article

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

Remarque

L’utilisation de cette fonction est déconseillée dans les calculs visuels, car elle est susceptible de retourner des résultats non pertinents.

Évalue la valeur de l’année à jour du expression dans le contexte actuel.

Syntaxe

TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])

Paramètres

Paramètre Définition
expression Expression qui retourne une valeur scalaire.
dates Colonne qui contient des dates.
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.

Valeur de retour

Valeur scalaire qui représente l'expression évaluée pour l’année en cours dates.

Remarques

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

  • Les contraintes sur les expressions booléennes sont décrites dans la rubrique CALCULATE.

  • L’expression filter a des restrictions décrites dans la rubrique CALCULATE.

  • 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 n’est pas obligatoire et est ignorée. Par exemple, la formule suivante spécifie le paramètre year_end_date 6/30 (exercice) pour un classeur dont les paramètres régionaux sont définis sur en-US.

    = TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey], ALL('DateTime'), "6/30")

    Dans cet exemple, year_end_date pouvez être spécifié comme « 6/30 », « 30 juin », « 30 juin » ou toute chaîne qui se résout sur un mois/jour. Toutefois, il est recommandé de spécifier year_end_date à l’aide de « mois/jour » (comme indiqué) pour vous assurer que la chaîne est résolue à une date.

  • 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 le « total d’exécution de l’année » ou la « somme d’exécution de l’année » pour les ventes Internet.

= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])

Contenu connexe

ALL CALCULATE DATESYTD TOTALMTD TOTALQTD