DATEADD (SSIS)
Gibt einen neuen DT_DBTIMESTAMP-Wert zurück, nachdem einem angegebenen datepart-Wert in einem Datum eine Zahl hinzugefügt wurde, die ein Datums- oder Zeitintervall darstellt. Der number-Parameter muss zu einer ganzen Zahl ausgewertet werden, und der date-Parameter muss zu einem gültigen Datum ausgewertet werden.
Syntax
DATEADD(datepart, number, date)
Argumente
datepart
Der Parameter, der angibt, welcher Datumseinheit eine Zahl hinzugefügt werden soll.
number
Der Wert, um den datepart inkrementiert wird. Dieser Wert muss ein ganzzahliger Wert sein, der beim Analysieren des Ausdrucks bekannt ist.
date
Ein Ausdruck, der ein gültiges Datum oder eine Zeichenfolge im Datumsformat zurückgibt.
Ergebnistypen
DT_DBTIMESTAMP
Hinweise
Die folgende Tabelle listet die Datumseinheiten und Abkürzungen auf, die von der Ausdrucksauswertung erkannt werden. Bei datepart-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt.
| Datumseinheit | Abkürzungen |
|---|---|
Year |
yy, yyyy |
Quarter |
qq, q |
Month |
mm, m |
Dayofyear |
dy, y |
Day |
dd, d |
week |
wk, ww |
Weekday |
dw, w |
Hour |
Hh |
Minute |
mi, n |
Second |
ss, s |
Millisecond |
Ms |
Das number-Argument muss beim Analysieren des Ausdrucks verfügbar sein. Bei diesem Argument kann es sich um eine Konstante oder eine Variable handeln. Spaltenwerte können nicht verwendet werden, weil diese Werte beim Analysieren des Ausdrucks nicht bekannt sind.
Das datepart-Argument muss in Anführungszeichen eingeschlossen werden.
Ein Datumsliteral muss explizit in einen der date-Datentypen umgewandelt werden.
DATEADD gibt ein NULL-Ergebnis zurück, wenn das Argument NULL ist.
Fehler werden gemeldet, wenn ein Datum ungültig ist, wenn die Datums- oder Zeiteinheit keine Zeichenfolge ist oder wenn der Inkrementierungswert keine statische ganze Zahl ist.
Beispiele
In diesem Beispiel wird dem aktuellen Datum ein Monat hinzugefügt.
DATEADD("Month", 1,GETDATE())
In diesem Beispiel werden den Datumsangaben in der ModifiedDate-Spalte 21 Tage hinzugefügt.
DATEADD("day", 21, ModifiedDate)
In diesem Beispiel werden einem Datumsliteral 2 Jahre hinzugefügt.
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")
Siehe auch
Verweis
DATEDIFF (SSIS)
DATEPART (SSIS)
DAY (SSIS)
MONTH (SSIS)
YEAR (SSIS)