Artykuł
05/11/2010

DATENAME (Transact-SQL)

Returns a character string that represents the specified datepart of the specified date

Aby zapoznać się z omówieniem wszystkich Transact-SQL Data i czas typów danych i funkcji, zobacz Data i godzina, Data typy i funkcje (języka Transact-SQL). Aby uzyskać informacje i przykłady, które są wspólne dla data i czas typów danych i funkcji zobacz Using Date and Time Data.

Topic link icon Konwencje składni języka Transact-SQL

DATENAME ( datepart , date )

Argumenty

datepart
Jest to część date Aby powrócić. Poniższa lista zawiera wszystkie ważne datepart argumenty. Odpowiedniki zmienne zdefiniowane przez użytkownika są nieprawidłowe.

datepart	Skróty
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
microsecond	mcs
nanosecond	ns
TZoffset	tz

date
Is an expression that can be resolved to a time, date, smalldatetime, datetime, datetime2, or datetimeoffset value.date can be an expression, column expression, user-defined variable, or string literal.

Aby uniknąć niejednoznaczności, za pomocą czterech cyfr.Aby uzyskać informacje dotyczące dwucyfrowego zapisu roku, zobacz two digit year cutoff Option.

Zwracany typ

nvarchar

Return Value

Każdy datepart i ich skróty zwracają tę samą wartość.

Zwracana wartość zależy od środowiska języka zestaw przy użyciu zestaw JĘZYKA ijęzyk domyślny logowania.Wartość zwracana jest uzależniona od opcji na DATEFORMAT USTAWIANIE if date to ciąg literału niektórych formatów. zestaw DATEFORMAT nie wpływa na wartość zwracana, gdy data jest wyrażenie kolumna daty lub czas typu danych.

W przypadku wersji SQL Server później niż SQL Server 2000, gdy date Parametr ma date argument typu danych, zwracana wartość zależy od ustawień określonych przy użyciu zestaw DATEFIRST.

TZoffset w parametrze datepart argumentu

Jeśli datepart argument jest TZoffset (tz) i date argument zawiera przesunięcie strefy czasowej nie, zwracane jest 0.

Smalldatetime Data argumentu

Kiedy date jest Smalldatetime, sekund są zwracane jako 00.

Zwrócona domyślne dla datepart nie oznacza to Data argumentu

Jeśli typ danych date Argument nie ma określonego datepart, wartość domyślna dla tej datepart zostaną zwrócone.

Na przykład, domyślnie rok miesiąc dzień dla każdego date Typ danych jest 1900-01-01. Poniższa instrukcja zawiera argumenty część data dla datepart, argument czas dla date, a następnie zwraca 1900, January, 1, 1, Monday.

SELECT DATENAME(year, '12:10:30.123')
    ,DATENAME(month, '12:10:30.123')
    ,DATENAME(day, '12:10:30.123')
    ,DATENAME(dayofyear, '12:10:30.123')
    ,DATENAME(weekday, '12:10:30.123');

Domyślna godzina minuty sekundy dla time Typ danych to 00: 00: 00. Poniższa instrukcja zawiera argumenty część czas dla datepart, argument data dla date, a następnie zwraca 0, 0, 0.

SELECT DATENAME(hour, '2007-06-01')
    ,DATENAME(minute, '2007-06-01')
    ,DATENAME(second, '2007-06-01');

Remarks

DATENAME może być używany na liście select, WHERE, HAVING, GROUP BY, ORDER BY klauzule.

Przykłady

W poniższym przykładzie zwraca wartość części data dla podanej data.

SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10')

Here is the result set.

datepart	Zwracanie wartości
year, yyyy, yy	2007
quarter, qq, q	4
month, mm, m	Październik
dayofyear, dy, y	303
day, dd, d	30
week, wk, ww	44
weekday, dw	Wtorek
hour, hh	12
minute, n	15
second, ss, s	32
millisecond, ms	123
microsecond, mcs	123456
nanosecond, ns	123456700
TZoffset, tz	310

Share via