TOTALYTD
S’applique à :
Colonne calculéeTable calculéeMesure
Calcul 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’expression pour l’année en cours jusqu’à ce jour dans le contexte actuel.
Syntaxe
TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])
Paramètres
| Paramètre | Définition |
|---|---|
| expression | Expression retournant une valeur scalaire. |
| dates | Colonne contenant 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 jusqu’à ce jour, par rapport à la colonne dates.
Remarques
L’argument dates peut être l’un des éléments suivants :
- Une référence à une colonne de date/d’heure.
- Une expression de table qui retourne une seule colonne de valeurs de date/heure
- Une expression booléenne qui définit une table de valeurs de date/heure à une seule colonne
Les contraintes sur les expressions booléennes sont décrites dans la rubrique CALCULATE.
Des restrictions s’appliquent à l’expression filter ; elles sont décrites dans la rubrique CALCULATE.
Le paramètre year_end_date est un littéral de chaîne d’une date. Ses paramètres régionaux sont identiques à ceux du client où le classeur a été créé. La partie année de la date n’est pas nécessaire 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 peut être spécifié sous les formes « 6/30 », « juin 30 » ou « 30 juin » ou par toute chaîne résolue en mois/jour. Toutefois, il est recommandé de spécifier le paramètre year_end_date au format « mois/jour » (comme indiqué) pour garantir la résolution correcte de la chaîne en date.
Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).
Exemple
L’exemple de formule suivant crée une mesure qui calcule la somme ou le total des ventes Internet de l’année en cours jusqu’à ce jour.
= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])