DATENAME (Transact-SQL)

Aktualisiert: 17. Juli 2006

Gibt eine Zeichenfolge zurück, die den angegebenen Wert für datepart des angegebenen Datums darstellt.

Wichtig:
Dieses Feature hat sich gegenüber früheren Versionen von SQL Server geändert. Weitere Informationen finden Sie unter Verhaltensänderungen von Datenbankmodul-Features in SQL Server 2005.

Transact-SQL-Syntaxkonventionen

Syntax

DATENAME ( datepart ,date )

Argumente

• datepart
  Der Parameter, der angibt, welche Datumseinheit zurückgegeben werden soll. Die folgende Tabelle listet Datumsteile 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

  Der Datumsteil weekday (dw) gibt den Wochentag (Sonntag, Montag usw.) zurück.

• 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. datetime-Werte werden immer in Anführungszeichen eingeschlossen. Da smalldatetime nur eine Genauigkeit auf die Minute aufweist, sind Sekunden und Millisekunden immer gleich 0, wenn ein smalldatetime-Wert verwendet wird. Weitere Informationen zu Datumsangaben finden Sie unter Datum und Uhrzeit (Transact-SQL). Weitere Informationen zum Angeben von Zeitwerten finden Sie unter Zeitformate.

  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 vor dem Umstellungsjahr. Wenn two-digit year cutoff z. B. auf 2049 (Standardeinstellung) festgelegt 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

nvarchar

Hinweise

SQL Server 2005-Datenbankmodul konvertiert bei Bedarf automatisch Zeichenwerte in datetime-Werte, so z. B., wenn Sie einen Zeichenwert mit einem datetime-Wert vergleichen.

Beispiele

Im folgenden Beispiel wird der Monatsname aus dem von GETDATE zurückgegebenen Datum extrahiert.

SELECT DATENAME(month, GETDATE()) AS 'Month Name';

Dies ist das Resultset.

Month Name

------------------------------

February

Im folgenden Beispiel wird der Monatsname aus einer Spalte extrahiert.

USE AdventureWorks;
GO
SELECT StartDate, DATENAME(month,StartDate) AS StartMonth
FROM Production.WorkOrder
WHERE WorkOrderID = 1;
GO

Dies ist das Resultset.

StartDate StartMonth

-------------------------------- ------------

2001-07-04 00:00:00.000 July

In den folgenden Beispielen wird jedes datepart-Argument mit dem date-Argument im folgenden Format angezeigt: 'YYYY-MM-DDTHH:MM:SS.xxx'.

SELECT DATENAME(year,'1995-10-30 12:15:32.123');
SELECT DATENAME(yy,'1995-10-30 12:15:32.123');
SELECT DATENAME(yyyy,'1995-10-30 12:15:32.123');
-- Return: 1995

SELECT DATENAME(quarter,'1995-10-30 12:15:32.123');
SELECT DATENAME(qq,'1995-10-30 12:15:32.123');
SELECT DATENAME(q,'1995-10-30 12:15:32.123');
-- Return: 4

SELECT DATENAME(month,'1995-10-30 12:15:32.123');
SELECT DATENAME(mm,'1995-10-30 12:15:32.123');
SELECT DATENAME(m,'1995-10-30 12:15:32.123');
-- Return: October

SELECT DATENAME(dayofyear,'1995-10-30 12:15:32.123');
SELECT DATENAME(dy,'1995-10-30 12:15:32.123');
SELECT DATENAME(y,'1995-10-30 12:15:32.123');
-- Return: 303

SELECT DATENAME(day,'1995-10-30 12:15:32.123');
SELECT DATENAME(dd,'1995-10-30 12:15:32.123');
SELECT DATENAME(d,'1995-10-30 12:15:32.123');
-- Return: 30

SELECT DATENAME(week,'1995-10-30 12:15:32.123');
SELECT DATENAME(wk,'1995-10-30 12:15:32.123');
SELECT DATENAME(ww,'1995-10-30 12:15:32.123');
-- Return: 44

SELECT DATENAME(weekday,'1995-10-30 12:15:32.123');
SELECT DATENAME(dw,'1995-10-30 12:15:32.123');
-- Return: Monday

SELECT DATENAME(hour,'1995-10-30 12:15:32.123');
SELECT DATENAME(hour,'1995-10-30 12:15:32.123');
SELECT DATENAME(hh,'10/30/1995 12:15:32.123 PM');
SELECT DATENAME(hh,'10/30/1995 12:15:32.123 PM');
-- Return: 12

SELECT DATENAME(minute,'1995-10-30 12:15:32.123');
SELECT DATENAME(mi,'1995-10-30 12:15:32.123');
SELECT DATENAME(n,'1995-10-30 12:15:32.123');
-- Return: 15
 
SELECT DATENAME(second,'1995-10-30 12:15:32.123');
SELECT DATENAME(ss,'1995-10-30 12:15:32.123');
SELECT DATENAME(s,'1995-10-30 12:15:32.123');
-- Return: 32

SELECT DATENAME(millisecond,'1995-10-30 12:15:32.123');
SELECT DATENAME(ms,'1995-10-30 12:15:32.123');
-- Return: 123

Änderungsverlauf

Version	Verlauf
17. Juli 2006	Neuer Inhalt: Beispiele wurden hinzugefügt.

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