Partager via


Fonction FIRSTDATE

Retourne la première date dans le contexte actuel pour la colonne de dates spécifiée.

Syntaxe

FIRSTDATE(<dates>)

Paramètres

Terme

Définition

dates

Colonne qui contient des dates.

Valeur de retour

Table contenant une seule colonne et une seule ligne avec une valeur de date.

Notes

[!REMARQUE]

Pour mieux comprendre la façon dont le contexte affecte les résultats des formules, consultez Contexte dans les formules DAX.

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

  • référence à une colonne date/heure ;

  • expression de table qui retourne une seule colonne de valeurs date/heure ;

  • expression booléenne qui définit une table à une seule colonne de valeurs date/heure.

[!REMARQUE]

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

Lorsque le contexte actuel est une date unique, la date retournée par les fonctions FIRSTDATE et LASTDATE sera la même.

Techniquement, la valeur de retour est une table qui contient une seule colonne et une seule valeur. Par conséquent, cette fonction peut être utilisée comme argument de toute fonction qui requiert une table dans ses arguments. De même, la valeur retournée peut être utilisée chaque fois qu'une valeur de date est requise.

Cette fonction DAX n'est pas prise en charge en mode DirectQuery. Pour plus d'informations sur les limitations dans les modèles DirectQuery, consultez https://go.microsoft.com/fwlink/?LinkId=219172.

Exemple

L'exemple de formule suivant crée une mesure qui obtient la première date à laquelle une vente sur Internet a été réalisée pour le contexte actuel.

Pour voir comment cela fonctionne, créez un tableau croisé dynamique et ajoutez le champ CalendarYear à la zone Étiquettes de ligne du tableau croisé dynamique. Ajoutez ensuite une mesure, nommée FirstSaleDate, à l'aide de la formule définie dans la section de code, à la zone Valeurs du tableau croisé dynamique.

=FIRSTDATE('InternetSales_USD'[SaleDateKey])

Voir aussi

Référence

Fonction LASTDATE

Fonction FIRSTNONBLANK

Autres ressources

Fonctions de date et d'heure (DAX)

Fonctions Time Intelligence (DAX)

Obtenir des exemples de données