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.
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")
Voir aussi
Référence
DATEDIFF (SSIS)
DATEPART (SSIS)
DAY (SSIS)
MONTH (SSIS)
YEAR (SSIS)