• Article

DATEADD (SSIS)

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

Année

yy, yyyy

Trimestre

qq, q

Mois

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 number doit être disponible lorsque 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 d'Integration Services.

[!REMARQUE]

La validation de l'expression échoue lorsqu'un littéral de date est explicitement converti en un des types de données de date suivants : DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2, et DT_DBTIME2.

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

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")