Fonction TOTALYTD
Évalue la valeur pour l'année en cours jusqu'à ce jour de l'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 comportant 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 les dates de l'année en cours jusqu'à ce jour.
Notes
[!REMARQUE]
Pour mieux comprendre la façon dont le contexte affecte les résultats des formules, consultez Contexte dans les formules DAX.
L'argument dates peut être l'un des éléments suivants :
référence à une colonne date/heure ;
expression de table qui retourne une seule colonne de valeurs date/heure ;
expression booléenne qui définit une table à une seule colonne de valeurs date/heure.
[!REMARQUE]
Les contraintes sur les expressions booléennes sont décrites dans la rubrique Fonction CALCULATE.
[!REMARQUE]
Des restrictions s'appliquent à l'expression de filtre ; elles sont décrites dans la rubrique Fonction CALCULATE.
Le paramètre year_end_date est un littéral de chaîne d'une date utilisant les mêmes paramètres régionaux que ceux du client où le classeur a été créé. La partie année de la date est ignorée.
Cette fonction DAX n'est pas prise en charge en mode DirectQuery. Pour plus d'informations sur les limitations dans les modèles DirectQuery, consultez https://go.microsoft.com/fwlink/?LinkId=219172.
Exemple
L'exemple de formule suivant crée une mesure qui calcule le total cumulé de l'année (Year Running Total) et la somme cumulée de l'année (Year Running Sum) pour les ventes sur Internet (Internet sales).
Pour voir comment cela fonctionne, créez un tableau croisé dynamique, et ajoutez les champs CalendarYear, CalendarQuarter et MonthNumberOfYear à la zone Étiquettes de ligne du tableau croisé dynamique. Ajoutez ensuite une mesure, nommée Year-to-date Total, à l'aide de la formule définie dans la section de code, à la zone Valeurs du tableau croisé dynamique.
Code
=TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])