Partage via

DATEADD

  • Article

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

Note

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, décalée vers l’avant ou vers l’arrière par le nombre spécifié d’intervalles à partir des 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 ou soustraire des dates.
interval Intervalle par lequel déplacer les dates. La valeur de l’intervalle peut être l’une des 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 :

  • Référence à une colonne de date/heure,

  • Expression de table qui retourne une seule colonne de valeurs de date/heure,

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

    Note

    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 dates sont déplacées vers l’avant dans le temps ; si le nombre est négatif, les dates dans dates sont décalées dans le temps.

  • Le paramètre interval est une énumération, et non un ensemble de chaînes ; par conséquent, les valeurs ne doivent pas être placées entre guillemets. En outre, les valeurs : year, quarter, month, day doivent être orthographiés en intégralité lors de leur utilisation.

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

  • Si les dates dans le contexte actuel ne forment pas d’intervalle contigu, la fonction retourne une erreur.

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

La formule suivante calcule les dates qui sont d’un an avant les dates dans le contexte actuel.

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

Contenu connexe

fonctions Time Intelligencefonctions Date et heure