Lire en anglais

Partager via


DATESBETWEEN

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Notes

Cette fonction est déconseillée pour une utilisation dans calculs visuels car elle retourne probablement des résultats sans signification.

Retourne une table qui contient une colonne de dates qui commence par une date de début spécifiée et se poursuit jusqu’à une date de fin spécifiée.

Cette fonction est adaptée pour passer en tant que filtre à la fonction CALCULATE. Utilisez-la pour filtrer une expression selon une plage de dates personnalisée.

Notes

Si vous travaillez avec des intervalles de date standard tels que des jours, des mois, des trimestres ou des années, il est recommandé d’utiliser la fonction DATESINPERIOD mieux adaptée.

Syntaxe

DAX
DATESBETWEEN(<Dates>, <StartDate>, <EndDate>)

Paramètres

Terme Définition
Dates Colonne de date.
StartDate Expression de date.
EndDate Expression de date.

Valeur de retour

Table contenant une seule colonne de valeurs de date.

Remarques

  • Dans le cas d’usage le plus courant, dates est une référence à la colonne date d’une table de dates marquée.

  • Si StartDate est VIDE, StartDate sera la valeur la plus ancienne de la colonne dates.

  • Si EndDate est VIDE, EndDate sera la valeur la plus récente dans la colonne dates.

  • Les dates utilisées comme StartDate et les EndDate sont inclusives. Par exemple, si la valeur StartDate est le 1er juillet 2019, cette date sera incluse dans la table retournée (en indiquant que la date existe dans la colonne dates).

  • La table retournée ne peut contenir que des dates stockées dans la colonne Dates. Par exemple, si la colonne Dates commence à partir du 1er juillet 2017 et que la valeur StartDate est le 1er juillet 2016, la table retournée commence à partir du 1er juillet 2017.

  • 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

La définition de mesure de table Sales suivante utilise la fonction DATESBETWEEN pour produire un calcul (LTD) de durée de vie. La durée de vie à ce jour représente l’accumulation d’une mesure au fil du temps depuis le début de l’heure.

Notez que la formule utilise la fonction MAX. Cette fonction retourne la date la plus récente dans le contexte de filtre. Par conséquent, la fonction DATESBETWEEN retourne une table de dates commençant par la date la plus ancienne jusqu’à la date la plus récente signalée.

Les exemples de cet article peuvent être utilisés avec l’exemple de modèle Adventure Works DW 2020 Power BI Desktop. Pour obtenir le modèle, consultez exemple de modèle DAX.

DAX
Customers LTD =
CALCULATE(
    DISTINCTCOUNT(Sales[CustomerKey]),
    DATESBETWEEN(
        'Date'[Date],  
        BLANK(),  
        MAX('Date'[Date])  
    )
)

Considérez que la date la plus ancienne stockée dans la table date est le 1er juillet 2017. Ainsi, lorsqu’un rapport filtre la mesure d’ici le mois de juin 2020, la fonction DATESBETWEEN retourne une plage de dates comprise entre le 1er juillet 2017 et le 30 juin 2020.