DATESYTD

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.

Pour l’entrée de colonne de date, retourne une table qui contient une colonne des dates de l’année à la date, dans le contexte actuel.
Pour les entrées de calendrier, retourne une table pour l’année à ce jour, dans le contexte actuel. La table contient toutes les colonnes marquées principales et toutes les colonnes associées à l’heure.

Syntaxe

DATESYTD(<dates> or <calendar> [,<year_end_date>])

Paramètres

Terme	Définition
dates or calendar	Colonne qui contient des dates ou une référence de calendrier.
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

Pour l’entrée de colonne de date, une table contenant une seule colonne de valeurs de date.
Pour l’entrée de calendrier, une table qui contient toutes les colonnes marquées principales et toutes les colonnes associées à l’heure.

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.

  Note

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

• 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. Selon les paramètres régionaux, le format peut ressembler à « m-dd » ou « dd-m ».

• 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 le « Total en cours d’exécution » pour les ventes Internet.

= CALCULATE (
    SUM ( InternetSales_USD[SalesAmount_USD] ),
    DATESYTD ( DateTime[DateKey] )
)

L’exemple de formule suivant crée une mesure qui calcule le « Total d’exécution de l’exercice fiscal » pour les ventes Internet, à l’aide d’un paramètre régional américain pour le format Date.

= CALCULATE(
    SUM(InternetSales_USD[SalesAmount_USD]), 
    DATESYTD(DateTime[DateKey],
        "6-30"
        )
)

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

L’exemple de formule suivant crée une mesure qui calcule le « Total en cours d’exécution » pour le calendrier fiscal des ventes Internet.

= CALCULATE (
    SUM ( InternetSales_USD[SalesAmount_USD] ),
    DATESYTD ( FiscalCalendar )
)

Contenu connexe

Fonction fonction de fonction fonction date et heure d’intelligence de l’heureDATESWTDDATESMTDDATESQTD