DATEDIFF

Syntaxe

Paramètres

Description

Cette fonction permet de retourner le nombre d'intervalles entre deux dates, selon l'unité spécifiée (jour, mois, année,...).

Remarques

• Calcul de différence entre deux dates : La fonction DATEDIFF permet de calculer l'écart entre deux dates spécifiques. Cela est très utile pour mesurer la durée entre un début et une fin, par exemple la durée d'un projet ou le temps écoulé depuis une commande jusqu'à sa livraison. Elle fournit un résultat numérique en fonction de l'unité temporelle choisie.
• Support de multiples unités : DATEDIFF peut calculer la différence en secondes, minutes, heures, jours, semaines, mois, trimestres ou années. Cette flexibilité permet d'adapter l'analyse selon le contexte : suivi journalier des ventes, durée des cycles de production, ou mesure annuelle des performances.
• Date de début et date de fin : Les paramètres Date1 et Date2 permettent de spécifier la date de départ et la date d'arrivée. L'ordre des dates influence le signe du résultat, les valeurs négatives indiquant que la première date est postérieure à la deuxième, ce qui est important pour des calculs de délais ou de retards.
• Utilisation avec des colonnes ou expressions : DATEDIFF accepte des colonnes de type date ou des expressions DAX retournant une date. Cela permet de l'intégrer dans des mesures complexes, comme calculer le nombre de jours entre la date de commande et la date de livraison pour chaque ligne d'une table de faits.
• Résultat numérique simple : La fonction retourne une valeur numérique entière représentant le nombre total d'intervalles complets entre les deux dates. Par exemple, si l'on calcule la différence en mois entre le 31 janvier et le 1er mars, DATEDIFF retournera 1 mois complet, ce qui peut être utile pour des regroupements temporels.
• Intégration avec CALCULATE et FILTER : DATEDIFF peut être combinée avec CALCULATE ou FILTER pour créer des mesures dynamiques dans Power BI. Par exemple, on peut calculer le nombre de clients ayant passé une commande dans les 30 derniers jours en utilisant DATEDIFF pour filtrer les dates pertinentes.
• Analyse de durée dans le temps : La fonction est particulièrement utile pour les analyses de type "lead time" ou "cycle time". Elle permet de mesurer précisément les durées de processus, le temps entre des événements ou encore la fidélité des clients en calculant la différence entre la première et la dernière commande.
• Compatibilité et cohérence : DATEDIFF fonctionne de manière cohérente sur tous les modèles tabulaires Power BI, Analysis Services et Excel Data Model. Elle prend en compte les dates valides et retourne une erreur si l'une des dates est BLANK, ce qui garantit des résultats fiables pour les mesures et les visualisations de type Gantt ou KPI temporels.