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는 식, 열 식, 사용자 정의 변수 또는 문자열 리터럴일 수 있습니다.

  모호성을 피하려면 4자리 연도를 사용하십시오. 2자리 연도에 대한 자세한 내용은 two digit year cutoff 옵션을 참조하십시오.

반환 형식

nvarchar

반환 값

• 각 datepart와 해당 약어는 동일한 값을 반환합니다.

반환 값은 SET LANGUAGE 및 로그인의 기본 언어를 통해 설정된 언어 환경에 따라 다릅니다. date가 특정 문자열 리터럴 형식이면 반환 값은 SET DATEFORMAT에 따라 달라집니다. date가 날짜 또는 시간 데이터 형식의 열 식이면 SET DATEFORMAT은 반환 값에 영향을 주지 않습니다.

SQL Server 2000 이상의 SQL Server 버전에서는 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은 SELECT 목록, WHERE, HAVING, GROUP BY 및 ORDER BY 절에서 사용할 수 있습니다. SQL Server 2008에서 DATENAME은 암시적으로 문자열 리터럴을 datetime2 유형으로 캐스팅합니다. DATENAME과 DATEADD를 함께 사용할 때는 문자열 리터럴을 암시적으로 캐스팅하지 않는 것이 좋습니다. 자세한 내용은 DATEADD(Transact-SQL)를 참조하십시오.

예

다음 예는 지정된 날짜에 대한 날짜 부분을 반환합니다.

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

결과 집합은 다음과 같습니다.

참고 항목

참조