DATEADD (SSIS-Ausdruck)
Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory
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.
Zahl
Der Wert, um den datepartinkrementiert 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
In der folgenden Tabelle sind die datepart-Werte und Abkürzungen aufgeführt, die von der Ausdrucksauswertung erkannt werden. Bei datepart-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt.
datepart | Abkürzungen |
---|---|
Jahr | yy, yyyy |
Quarter | qq, q |
Month (Monat) | mm, m |
Dayofyear | dy, y |
Tag | dd, d |
Woche | wk, ww |
Wochentag | dw, w |
Stunde | Hh |
Minute | mi, n |
Second | ss, s |
Millisekunde | 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. Weitere Informationen finden Sie unter Integration Services Datentypen.
DATEADD gibt ein NULL-Ergebnis zurück, wenn das Argument NULL ist.
Fehler treten auf, wenn ein Datum ungültig, die Datums- oder Zeiteinheit keine Zeichenfolge oder das Inkrement keine statische ganze Zahl ist.
Beispiele für SSIS-Ausdrücke
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
DATEDIFF (SSIS-Ausdruck)
DATEPART (SSIS-Ausdruck)
DAY (SSIS-Ausdruck)
MONTH (SSIS-Ausdruck)
YEAR (SSIS-Ausdruck)
Funktionen (SSIS-Ausdruck)