Freigeben über


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)

Andere Ressourcen

Funktionen (SSIS)

Hilfe und Informationen

Informationsquellen für SQL Server 2005