Partager via


DATESYTD

S’applique à :Colonne calculéeTable calculéeMesureCalcul de visuel

Remarque

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

Retourne une table qui contient une colonne des dates de l’année jusqu’à ce jour, dans le contexte actuel.

Syntaxe

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

Paramètres

Terme Définition
dates Colonne qui contient des dates.
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 renvoyée

Table contenant une seule colonne de valeurs de date.

Remarques

L’argument dates peut être l’un des éléments suivants :

  • Une référence à une colonne de date/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

    Notes

    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. Ses paramètres régionaux sont identiques à ceux 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 être « m-jj » ou « jj-m ».

  • 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 le « total cumulé » des ventes sur Internet.

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

L’exemple de formule suivant crée une mesure qui calcule le « Total cumulé de l’année fiscale » pour les ventes sur Internet à l’aide des paramètres régionaux US pour le format Date.

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

Fonctions d’intelligence temporelle
Fonctions de date et heure
DATESMTD, fonction
DATESQTD, fonction