Menü

DateName

Zurück | Ebene zurück

Beschreibung

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

Syntax

DATENAME ( datepart , date )

Argumente

datepart

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

date
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

Die Datumseinheit weekday (dw) gibt den Wochentag (Sonntag, Montag usw.) zurück.

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 Zeitpunkte 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 Null, wenn ein smalldatetime-Wert verwendet wird. Weitere Informationen zu Datumsangaben finden Sie unter „datetime“ und „smalldatetime“. 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, 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

nvarchar

Hinweise

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

Beispiel 1 - Monatsname

SELECT GETDATE() Heute, DATENAME(MONTH, GETDATE()) Monat
GO
Heute                          Monat                          
------------------------------ ------------------------------ 
2001-02-12 15:05:31.647        Februar

(1 row(s) affected)

Der Select-Befehl gibt zwei Spalten aus, in der ersten das aktuelle Tagesdatum, und in der 2. Spalte den Monatsnamen zum Tagesdatum.

Jeder Spalte wird eineigener Alias zugeordnet, der einfach mit einem Leerzeichen getrennt wird. Die Spalte für das Tagesdatum wird mit Heute bezeichnet und die zweite mit Monat.

Anstatt des Parameters MONTH für die Datumseinheit, kann auch die MM oder M benutzt werden.

Beispiel 2 - Kalenderwoche

SELECT GETDATE() Heute, DATENAME(WEEK, GETDATE()) Woche
GO
Heute                          Woche                          
------------------------------ ------------------------------ 
2001-02-12 15:10:04.247        7

(1 row(s) affected)

Der Select-Befehl gibt zwei Spalten aus, in der ersten das aktuelle Tagesdatum, und in der 2. Spalte die Kalenderwoche.

Anstatt des Parameters WEEK für die Datumseinheit, kann auch die WK oder WW benutzt werden.

Siehe auch

Datentypen des SQL Server