FIRSTDATE

Syntaxe

Paramètres

Description

Cette fonction permet de retourner la première date dans le contexte courant pour une colonne de dates spécifiée.

Remarques

• Rôle fondamental dans l'analyse temporelle : La fonction FIRSTDATE est principalement utilisée dans les analyses temporelles pour identifier la première date disponible dans un contexte donné. Elle est très courante dans les modèles DAX exploitant des tables de dates ou de calendriers. En retournant la date la plus ancienne visible dans le contexte courant, elle permet de poser des bases chronologiques solides pour des calculs d'évolution, de cumul ou de comparaison dans le temps.
• Importance du paramètre dates : Le paramètre dates doit correspondre à une colonne contenant exclusivement des valeurs de type date ou datetime. Il est généralement recommandé d'utiliser une colonne issue d'une table de dates dédiée, afin d'assurer la cohérence des calculs. Une mauvaise référence de colonne peut entraîner des résultats erronés ou incohérents, notamment dans des modèles complexes.
• Dépendance au contexte de filtre : FIRSTDATE dépend entièrement du contexte de filtre actif au moment de l'évaluation. Les segments, filtres de page, filtres de rapport ou relations entre tables influencent directement la date retournée. Ainsi, la première date peut varier dynamiquement selon les sélections de l'utilisateur, ce qui rend cette fonction particulièrement adaptée aux tableaux de bord interactifs.
• Différence avec MIN : Bien que FIRSTDATE et MIN puissent sembler similaires, leur comportement diffère subtilement. FIRSTDATE retourne une valeur de type date dans un contexte temporel, tandis que MIN est une fonction d'agrégation générique. FIRSTDATE est souvent préférée dans les scénarios d'intelligence temporelle car elle est conçue pour fonctionner naturellement avec les tables de dates et les fonctions de time intelligence.
• Utilisation avec les fonctions de time intelligence : FIRSTDATE est fréquemment utilisée en combinaison avec des fonctions comme DATESYTD, DATESMTD ou SAMEPERIODLASTYEAR. Elle permet par exemple de déterminer le point de départ d'un cumul ou d'un calcul comparatif. Cette complémentarité renforce la puissance des analyses temporelles en DAX.
• Comportement avec les valeurs vides : Lorsque la colonne de dates contient des valeurs vides ou que le contexte ne retourne aucune date, FIRSTDATE renvoie BLANK. Ce comportement doit être anticipé dans les mesures, notamment à l'aide de fonctions conditionnelles comme IF ou COALESCE. Cela permet d'éviter des résultats inattendus ou des visuels incomplets.
• Utilisation dans les mesures plutôt que dans les colonnes calculées : FIRSTDATE est principalement destinée à être utilisée dans des mesures, car elle dépend fortement du contexte de filtre dynamique. Son utilisation dans des colonnes calculées est limitée et souvent non pertinente, puisque ces colonnes sont évaluées une seule fois lors du rafraîchissement du modèle. Les mesures offrent donc un cadre beaucoup plus adapté à son usage.
• Bonnes pratiques et lisibilité : Il est conseillé de documenter clairement l'usage de FIRSTDATE dans les mesures, en précisant le contexte temporel attendu. Utiliser des variables (VAR) pour stocker la date retournée peut améliorer la lisibilité et la maintenance du code. Enfin, s'assurer que le modèle dispose d'une table de dates correctement marquée est une condition essentielle pour exploiter pleinement cette fonction.