DATEADD (Transact-SQL)

Aktualisiert: 14. April 2006

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

Transact-SQL-Syntaxkonventionen

Syntax

DATEADD (datepart , number, date )

Argumente

• datepart
  Der Parameter, der angibt, für welche Datumseinheit ein neuer Wert zurückgegeben werden soll. Die folgende Tabelle listet die Datumsteile und Abkürzungen auf, die von der Ausdrucksauswertung Microsoft SQL Server 2005 erkannt werden.

  Datumsteil	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

• number
  Der Wert, um den datepart inkrementiert 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 inkrementiert.

• date
  Ist ein Ausdruck, der einen datetime- oder smalldatetime-Wert oder eine Zeichenfolge in einem Datumsformat zurückgibt. Weitere Informationen zu Datumsangaben finden Sie unter Datum und Uhrzeit (Transact-SQL).

  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, in demselben 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 Mehrdeutigkeit von Datumsangaben zu vermeiden, sollten Sie vierstellige Jahresangaben verwenden.

Rückgabetypen

Gibt datetime zurück, bzw. gibt smalldatetime zurück, wenn das date-Argument vom Typ smalldatetime ist.

Hinweise

Wenn datepart den Wert month hat, beeinflusst die Anzahl der Tage im Monat das Ergebnis. Beispielsweise hat der August 31 Tage und der September 30 Tage. Die beiden folgenden Anweisungen geben jeweils 2006-09-30 00:00:00.000 zurück.

SELECT DATEADD(month, 1, '08/30/2006')
SELECT DATEADD(month, 1, '08/31/2006')

Anders ausgedrückt, wird durch Addieren eines Monats zu Ende August der letzte Tag im September zurückgegeben.

Beispiele

Das folgende Beispiel druckt eine Liste eines Zeitrahmens für Bestellungen in der AdventureWorks-Datenbank. Der Zeitrahmen stellt das vorhandene Bestelldatum plus 21 Tage dar.

USE AdventureWorks;
GO
SELECT DATEADD(day, 21, OrderDate)AS TimeFrame 
FROM Sales.SalesOrderHeader;
GO

Siehe auch

Verweis

CAST und CONVERT (Transact-SQL)
Datentypen (Transact-SQL)
Datums- und Zeitfunktionen (Transact-SQL)

Andere Ressourcen

ISO 8601-Format
Alphabetisches Datumsformat
Numerisches Datumsformat
ODBC-Datetime-Format
Zeitformate
Unstrukturierte Zeichenfolgen

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf