Partager via


DATEADD

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 de dates avancées ou reculées dans le temps du nombre d’intervalles spécifié par rapport aux dates dans le contexte actuel.

Syntaxe

DATEADD(<dates>,<number_of_intervals>,<interval>)  

Paramètres

Terme Définition
dates Colonne qui contient des dates.
number_of_intervals Entier qui spécifie le nombre d’intervalles à ajouter aux dates ou à soustraire des dates.
interval Intervalle selon lequel les dates doivent être avancées ou reculées. L’intervalle peut avoir l’une des valeurs suivantes : year, quarter, month, day

Valeur de retour

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.

  • Si le nombre spécifié pour number_of_intervals est positif, les dates dans la colonne dates sont avancées dans le temps ; s’il est négatif, les dates dans la colonne dates sont reculées dans le temps.

  • Le paramètre interval est une énumération, pas un ensemble de chaînes ; les valeurs ne doivent donc pas être placées entre guillemets. De plus, si vous utilisez les valeurs year, quarter, month ou day, vous devez les spécifier en toutes lettres.

  • La table de résultats inclut uniquement les dates qui existent dans la colonne dates.

  • Si les dates dans le contexte actuel ne constituent pas un intervalle contigu, la fonction retourne une erreur.

  • 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 de décalage d’un ensemble de dates

La formule suivante calcule des dates qui sont antérieures d’un an aux dates dans le contexte actuel.

= DATEADD(DateTime[DateKey],-1,year)  

Fonctions d’intelligence temporelle
Fonctions de date et heure