DATENAME (Transact-SQL)

Синтаксис

DATENAME ( datepart , date )

Аргументы

• datepart
  Отображаемая часть переменной date. В следующей таблице перечислены все допустимые аргументы datepart. Эквивалентные переменные, определяемые пользователем, являются недопустимыми.

  datepart	Сокращения
  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
  Выражение, которое можно привести к значению типа time, date, smalldatetime, datetime, datetime2 или datetimeoffset. Параметр date может быть выражением, выражением столбца, определяемой пользователем переменной или строковым литералом.

  Во избежание неоднозначности используйте четырехзначную запись года. Дополнительные сведения о двузначном обозначении года см. в разделе Параметр two digit year cutoff.

Тип возвращаемых данных

nvarchar

Возвращаемое значение

• Каждое выражение datepart и его краткие формы возвращают одно и то же значение.

Возвращаемое значение зависит от языка среды, задаваемого инструкцией SET LANGUAGE, и от языка, используемого по умолчанию для имени входа. Если значение date является строковым литералом некоторого формата, то возвращаемое значение зависит от функции SET DATEFORMAT. Инструкция SET DATEFORMAT не влияет на возвращаемое значение, если дата представляется выражением столбца типа данных даты или времени.

В версиях SQL Server выше SQL Server 2000, если параметр date имеет аргумент типа date, то возвращаемое значение зависит от настроек, заданных с помощью функции SET DATEFIRST.

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');

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

Замечания

Функция DATENAME может использоваться в предложениях WHERE, HAVING, GROUP BY и ORDER BY, а также при составлении списка выбора. В SQL Server 2008 R2 DATENAME неявно приводит строковые литералы к типу datetime2. Это означает, что DATEDIFF больше не поддерживает формат «гдм», где дата передается в качестве строки. Необходимо явно привести строку в тип datetime или smalldatetime для использования формата «гдм».

Примеры

В следующем примере производится отображение частей указанной даты.

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

Ниже приводится результирующий набор.

См. также

Справочник