Menü

DateAdd

Zurück | Ebene zurück

Beschreibung

Gibt einen neuen datetime-Wert zurück, der auf dem Hinzufügen eines Intervalls zum angegebenen Datum basiert.

Syntax

DATEADD ( datepart , number, date )

Argumente

datepart

Der Parameter, der angibt, für welche Datumseinheit ein neuer Wert zurückgegeben werden soll. Die Tabelle listet die Datumseinheiten und Abkürzungen auf, die von Microsoft® SQL Server™ erkannt werden.

Datumseinheit Abkürzungen
year yy, yyyy
quarter qq, q
month mm, m
dayofyear dy, y
day dd, d
week wk, ww
hour hh
minute mi, n
second ss, s
millisecond ms
 

number

Der Wert, um den datepart erhöht wird. Wenn Sie einen Wert angeben, der keine ganze Zahl ist, werden die Dezimalstellen des Wertes entfernt. Wenn Sie z. B. day für datepart und 1.75 für number angeben, wird date um 1 erhöht.

date

Ein Ausdruck, der einen datetime- oder smalldatetime-Wert oder eine Zeichenfolge in einem Datumsformat zurückgibt. Weitere Informationen zum Angeben von Datumsangaben finden Sie unter „datetime“ und „smalldatetime“.

Wenn Sie nur die letzten beiden Ziffern der Jahreszahl angeben, liegen Werte, die kleiner oder gleich den letzten beiden Ziffern des Wertes der Konfigurationsoption two digit year cutoff sind, im selben Jahrhundert wie das Umstellungsjahr. Werte, die größer als die letzten beiden Ziffern des Wertes dieser Option sind, liegen in dem Jahrhundert, das dem Jahrhundert des Umstellungsjahres vorausgeht. Wenn two digit year cutoff z. B. auf 2049 (Standardeinstellung) eingestellt ist, wird das Jahr 49 als 2049 und das Jahr 50 als 1950 interpretiert. Um die Zweideutigkeit von Datumsangaben zu vermeiden, sollten Sie vierstellige Jahresangaben verwenden.

Rückgabetypen

Gibt Werte vom Typ datetime zurück; wenn jedoch das Argument date vom smalldatetime-Datentyp ist, werden Werte vom Typ smalldatetime zurückgegeben.

Beispiel 1 - Zehn Tage später

SELECT GETDATE() Heute,
       DATEADD(DAY,10,GETDATE()) InZehnTagen
GO
Heute                          InZehnTagen
------------------------------ ------------------------------
2001-02-12 12:56:41.610        2001-02-22 12:56:41.610

(1 row(s) affected)

Anstatt des Intervall-Bezeichners DAY kann auch die DD oder D benutzt werden.

Beispiel 2 - Zwei Monate später

SELECT GETDATE() Heute ,
       DATEADD(MONTH,2,GETDATE()) InZweiMonaten
GO
Heute                          InZweiMonaten
------------------------------ ------------------------------
2001-02-12 13:18:21.597        2001-04-12 13:18:21.597

(1 row(s) affected)

Anstatt des Intervall-Bezeichners MONTH kann auch die MM  oder M benutzt werden.

Beispiel 3 - ein Vierteljahr später

SELECT GETDATE() Heute ,
       DATEADD(QUARTER,1,GETDATE()) ImViertelJahr
GO
Heute                          ImViertelJahr
------------------------------ ------------------------------
2001-02-12 13:20:04.210        2001-05-12 13:20:04.210

(1 row(s) affected)

Anstatt des Intervall-Bezeichners QUARTER kann auch die QQ oder Q benutzt werden.

Siehe auch

Datentypen des SQL Server