Partager via

DATEADD

  • Article

s’applique à :colonne calculéetable calculéeMeasurecalcul 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 contains une colonne de dates, décalée vers l’avant or vers l’arrière dans time 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 contains dates.
number_of_intervals Entier qui spécifie le nombre d’intervalles à ajouter à or soustraire des dates.
interval Intervalle par lequel déplacer les dates. Le value pour l’intervalle peut être l’un des éléments suivants : year, quarter, month, day

Retourner value

Table contenant une seule colonne de datevalues.

Remarques

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

  • Référence à une colonne date/time,

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

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

    Note

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

  • If le nombre spécifié pour number_of_intervals est positif, les dates de dates sont déplacées vers l’avant dans time; if le nombre est négatif, les dates de dates sont décalées dans time.

  • Le paramètre interval est une énumération, not un ensemble de chaînes ; par conséquent, values doit not être placée entre guillemets. En outre, le values: year, quarter, month, day doit être orthographié en intégralité lors de leur utilisation.

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

  • If les dates dans le contexte actuel forment not un intervalle contigu, la fonction retourne une error.

  • Cette fonction est not prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées or 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 une year avant les dates dans le contexte actuel.

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

contenu Related

fonctions Time intelligenceDateandtime fonctions