Partager via


DATEADD (expression SSIS)

S’applique à : SQL Server SSIS Integration Runtime dans Azure Data Factory

Renvoie une nouvelle valeur DT_DBTIMESTAMP après l'ajout d'un nombre qui représente un intervalle de date ou d'heure à la partie de date spécifiée d'une date. Le paramètre numérique doit s'évaluer à un entier et le paramètre de date doit s'évaluer à une date valide.

Syntaxe

  
DATEADD(datepart, number, date)  

Arguments

datepart
Paramètre spécifiant la partie de la date à laquelle ajouter un nombre.

number
Valeur utilisée pour incrémenter datepart. La valeur doit être une valeur entière connue au moment de l'analyse de l'expression.

date
Expression renvoyant une date valide ou une chaîne dans un format de date.

Types des résultats

DT_DBTIMESTAMP

Notes

Le tableau suivant décrit les parties de date et les abréviations reconnues par l'évaluateur d'expression. Les noms de partie de date ne respectent pas la casse.

partie de date Abréviations
Year yy, yyyy
Quarter (Trimestre) qq, q
Month mm, m
Jour de l'année dy, y
Jour dd, d
Semaine wk, ww
Jour de la semaine dw, w
Heure Hh
Minute mi, n
Seconde ss, s
Milliseconde Ms

L’argument nombre doit être disponible quand l’expression est analysée. Cet argument peut être une constante ou une variable. Vous ne pouvez pas utiliser des valeurs de colonne car celles-ci ne sont pas connues lorsque l'expression est analysée.

L’argument datepart doit être placé entre guillemets.

Un littéral de date doit être explicitement converti dans l'un des types de données date. Pour plus d’informations, consultez Types de données Integration Services.

La fonction DATEADD renvoie un résultat NULL si l'argument est NULL.

Des erreurs se produisent dans les cas suivants : une date n'est pas valide, l'unité de date ou d'heure n'est pas une chaîne ou l'incrément n'est pas un entier statique.

Exemples d'expressions SSIS

L'exemple suivant ajoute un mois à la date actuelle.

DATEADD("Month", 1,GETDATE())  

L’exemple suivant ajoute 21 jours aux dates de la colonne ModifiedDate .

DATEADD("day", 21, ModifiedDate)  

L'exemple suivant ajoute 2 années à une date littérale.

DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")  

Voir aussi

DATEDIFF (expression SSIS)
DATEPART (expression SSIS)
DAY (expression SSIS)
MONTH (expression SSIS)
YEAR (expression SSIS)
Fonctions (expression SSIS)