DATESYTD

Syntaxe

Paramètres

Description

Cette fonction permet de retourner une table contenant les dates de l'année en cours jusqu'à la date actuelle dans le contexte.

Remarques

• Cumul annuel automatique : DATESYTD retourne une table contenant toutes les dates depuis le début de l'année jusqu'à la dernière date disponible dans le contexte de calcul. Cette fonction est très pratique pour calculer des cumuls annuels tels que le chiffre d'affaires ou les dépenses, sans avoir besoin de définir manuellement les bornes de l'année.
• Dépendance au contexte : Le résultat dépend du contexte de filtre appliqué dans le rapport ou la visualisation. Par exemple, si le filtre limite les dates à un mois ou à un trimestre spécifique, seules les dates correspondant à ce contexte et incluses depuis le début de l'année seront prises en compte.
• Paramètre year_end_date : Le paramètre optionnel year_end_date permet de définir une date de fin d'année différente du 31 décembre. Cela est utile pour les exercices fiscaux ou comptables qui ne suivent pas l'année civile, par exemple une année fiscale se terminant le 30 septembre.
• Table en sortie : DATESYTD retourne une table de dates, et non une seule valeur. Cela signifie que la fonction est souvent utilisée comme paramètre dans des fonctions d'agrégation telles que CALCULATE, SUM ou AVERAGE pour effectuer des calculs cumulés "Year-to-Date" (YTD).
• Utilisation avec CALCULATE : La combinaison la plus fréquente est avec CALCULATE, pour calculer par exemple :
CALCULATE(SUM(Sales[Amount]), DATESYTD('Date'[Date])).

Cela permet d'obtenir le total des ventes accumulées depuis le début de l'année jusqu'à la date actuelle du contexte de visualisation.

• Nécessité d'une table de dates : Le paramètre dates doit être une colonne complète et continue de type date. Une table de dates correctement conçue est essentielle pour que DATESYTD fonctionne correctement, surtout pour les calculs sur plusieurs années ou avec des périodes fiscales décalées.
• Comparaison avec DATESMTD et DATESQTD : DATESYTD fait partie des fonctions temporelles cumulatives en DAX. Comparativement, DATESMTD retourne les dates du mois en cours et DATESQTD celles du trimestre. Ces fonctions simplifient le calcul de mesures cumulées sur différentes périodes temporelles.
• Sensibilité aux filtres et hiérarchies : DATESYTD est sensible aux filtres appliqués sur les colonnes de date et aux hiérarchies temporelles (mois, trimestre, année). Les filtres externes peuvent restreindre les dates retournées, et la précision des calculs dépend donc d'une bonne conception de la table de dates et d'une hiérarchie cohérente.