Freigeben über


DATUMADDIEREN (SSIS-Ausdruck)

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. Weitere Informationen finden Sie unter Integration Services-Datentypen.

HinweisHinweis

Der Ausdruck wird nicht überprüft, wenn ein Datumsliteral explizit in einen der folgenden Datumsdatentypen umgewandelt wird: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 oder DT_DBTIME2.

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")