Teilen über


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)