Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
s’applique à :
colonne calculéetable calculéemesure
calcul 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_intervalsest positif, les dates dansdatessont déplacées vers l’avant dans le temps ; si le nombre est négatif, les dates dansdatessont décalées dans le temps.Le paramètre
intervalest 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,daydoivent ê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)
Comportement spécial
Lorsque la sélection inclut les deux derniers jours du mois, DATEADD utilise la sémantique « extension » et inclut les jours jusqu’à la fin du mois. Par exemple, lorsque le 27 février et le 28 février 2013 sont inclus dans la sélection et qu’un mois est ajouté, DATEADD retournera le 27 mars au 31 mars.
Ce comportement se produit uniquement lorsque les deux derniers jours du mois sont inclus dans la sélection. Si seulement le 27 février est sélectionné, il passera au 27 mars.
= DATEADD(DateTime[DateKey], 1, month)