Kaufmännische Software für Handel, Handwerk und Produktionsbetriebe
DateAdd
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