DATEPART (Transact-SQL)

Gibt eine ganze Zahl zurück, die den angegebenen Teil für datepart des angegebenen Datums darstellt.

Transact-SQL-Syntaxkonventionen

Syntax

DATEPART ( datepart , date )

Argumente

• datepart
  Der Parameter, der angibt, welche Datumseinheit zurückgegeben werden soll. Die folgende Tabelle listet die Datumseinheiten und Abkürzungen auf, die von Microsoft SQL Server 2005 erkannt werden.

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

  Die Datumseinheit week (wk, ww) spiegelt an SET DATEFIRST vorgenommene Änderungen wider. Der 1. Januar eines Jahres definiert die Anfangszahl für die Datumseinheit week. Beispiel: DATEPART(wk,'Jan 1, xxxx') = 1, wobei xxxx ein beliebiges Jahr ist.

  Die Datumseinheit weekday (dw) gibt eine Zahl zurück, die dem Wochentag entspricht. Beispiel: Sonntag = 1, Samstag = 7. Die von der Datumseinheit weekday erzeugte Zahl hängt von dem Wert ab, der von SET DATEFIRST festgelegt wird. Dadurch wird der erste Tag der Woche festgelegt.

• date
  Ein Ausdruck, der einen datetime- oder smalldatetime-Wert oder eine Zeichenfolge in einem Datumsformat zurückgibt. Verwenden Sie den datetime-Datentyp nur für Datumsangaben nach dem 1. Januar 1753. Speichern Sie davor liegende Datumsangaben als Zeichendaten. Schließen Sie datetime-Werte beim Eingeben immer in Anführungszeichen ein. Da smalldatetime nur eine Genauigkeit auf die Minute aufweist, sind Sekunden und Millisekunden immer gleich NULL, wenn ein smalldatetime-Wert verwendet wird.

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

  Weitere Informationen zum Angeben der Zeitwerte finden Sie unter Zeitformate. Weitere Informationen zum Angeben von Datumswerten finden Sie unter Datum und Uhrzeit (Transact-SQL).

Rückgabetypen

int

Hinweise

Die Funktionen DAY, MONTH und YEAR sind Synonyme für DATEPART(**dd,**date), DATEPART(mm,date) bzw. DATEPART(yy, date).

Beispiele

Die GETDATE-Funktion gibt das aktuelle Datum zurück. Häufig ist jedoch nicht das vollständige Datum als Information erforderlich, sondern es wird nur ein Teil des Datums verglichen. Das folgende Beispiel zeigt die Ausgabe von GETDATE und DATEPART.

SELECT GETDATE() AS 'Current Date'
GO

Dies ist das Resultset.

Current Date                
--------------------------- 
Feb 18 1998 11:46PM         

SELECT DATEPART(month, GETDATE()) AS 'Month Number'
GO

Dies ist das Resultset.

Month Number 
------------ 
2            

Angenommen, das aktuelle Datum ist der 29. Mai:

SELECT DATEPART(month, GETDATE())
GO

Dies ist das Resultset.

----------- 
5           
(1 row(s) affected)

Im folgenden Beispiel wird das Datum als Zahl angegeben. Beachten Sie, dass SQL Server den Wert 0 als 1. Januar 1900 interpretiert.

SELECT DATEPART(m, 0), DATEPART(d, 0), DATEPART(yy, 0)

Dies ist das Resultset.

----- ------ ------
1     1      1900

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