DATENAME(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

이 함수는 지정한 date에서 특정 datepart를 나타내는 문자열을 반환합니다.

모든 Transact-SQL 날짜/시간 데이터 형식 및 함수에 대한 개요는 날짜 및 시간 데이터 형식 및 함수(Transact-SQL)를 참조하세요.

Transact-SQL 구문 표기 규칙

Syntax

DATENAME ( datepart , date )

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

datepart
DATENAME이 반환할 date 인수의 특정 부분입니다. 이 표에서는 올바른 datepart 인수가 모두 나열되어 있습니다.

참고

DATENAME은 datepart 인수에 해당하는 사용자 정의 변수 항목을 허용하지 않습니다.

datepart 약어
year yy, yyyy
quarter qq, q
month mm, m
dayofyear dy, y
day dd, d
week wk, ww
weekday dw, w
hour hh
minute mi, n
second ss, s
millisecond ms
microsecond mcs
nanosecond ns
TZoffset tz
ISO_WEEK ISOWK, ISOWW

date

다음 데이터 형식 중 하나를 확인할 수 있는 식입니다.

  • date
  • datetime
  • datetimeoffset
  • datetime2
  • smalldatetime
  • time

date의 경우 DATENAME은 열 식, 식, 문자열 리터럴 또는 사용자 정의 변수를 허용합니다. 모호성 문제를 피하려면 4자리 연도를 사용하세요. 두 자리 연도에 대한 정보는 두 자리 연도 구분 서버 구성 옵션 구성을 참조하세요.

반환 형식

nvarchar

Return Value

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

반환 값은 SET LANGUAGE 및 로그인의 기본 언어 구성 서버 구성 옵션을 사용하여 설정한 언어 환경에 따라 다릅니다. date가 특정 형식의 문자열 리터럴인 경우 반환 값은 SET DATEFORMAT에 따라 다릅니다. date가 날짜 또는 시간 데이터 형식의 열 식이면 SET DATEFORMAT은 반환 값을 변경하지 않습니다.

date 매개 변수에 date 데이터 형식 인수가 있으면 반환 값은 SET DATEFIRST에 의해 지정된 설정에 따라 달라집니다.

TZoffset datepart 인수

datepart 인수가 TZoffset(tz)이고 date 인수에 표준 시간대 오프셋이 없으면 DATEADD는 0을 반환합니다.

smalldatetime date 인수

date가 smalldatetime이면 DATENAME은 초를 00으로 반환합니다.

date 인수에 포함되지 않은 datepart는 기본값이 반환됨

date 인수의 데이터 형식에 지정된 datepart가 없으면 DATENAME은 date 인수가 리터럴인 경우에만 해당 datepart의 기본값을 반환합니다.

예를 들어 모든 date 데이터 형식의 년-월-일 기본값은 1900-01-01입니다. 다음 명령문은 datepart에 대한 날짜 부분 인수, date에 대한 시간 인수를 가지며 DATENAME은 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');

date가 변수 또는 테이블 열로 지정되고 해당 변수 또는 열의 데이터 형식에 지정된 datepart가 없으면 DATENAME은 오류 9810을 반환합니다. 이 예제에서 변수 @t는 time 데이터 형식입니다. 날짜 부분 연도가 time 데이터 형식에 적합하지 않으므로 이 예제는 실패입니다.

DECLARE @t time = '12:10:30.123';   
SELECT DATENAME(year, @t);

설명

다음 절에서 DATENAME를 사용합니다.

  • GROUP BY
  • HAVING
  • ORDER BY
  • SELECT <list>
  • WHERE

SQL Server에서 DATENAME은 문자열 리터럴을 datetime2 형식으로 암시적으로 캐스팅합니다. 즉 DATENAME는 데이터가 문자열로 전달될 때 형식 YDM을 지원하지 않습니다. YDM 형식을 사용하려면 문자열을 datetime 또는 smalldatetime 형식으로 명시적으로 캐스팅해야 합니다.

예

이 예는 지정된 날짜에 대한 날짜 부분을 반환합니다. SELECT 문의 datepart 인수에 대한 테이블에서 datepart 값을 대체합니다.

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

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

datepart 반환 값
year, yyyy, yy 2007
quarter, qq, q 4
month, mm, m 10월
dayofyear, dy, y 303
day, dd, d 30
week, wk, ww 44
weekday, dw 화요일
hour, hh 12
minute, n 15
second, ss, s 32
millisecond, ms 123
microsecond, mcs 123456
nanosecond, ns 123456700
TZoffset, tz +05:10
ISO_WEEK, ISOWK, ISOWW 44

Azure Synapse Analytics 및 분석 플랫폼 시스템(PDW)

이 예는 지정된 날짜에 대한 날짜 부분을 반환합니다. SELECT 문의 datepart 인수에 대한 테이블에서 datepart 값을 대체합니다.

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

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

datepart 반환 값
year, yyyy, yy 2007
quarter, qq, q 4
month, mm, m 10월
dayofyear, dy, y 303
day, dd, d 30
week, wk, ww 44
weekday, dw 화요일
hour, hh 12
minute, n 15
second, ss, s 32
millisecond, ms 123
microsecond, mcs 123456
nanosecond, ns 123456700
TZoffset, tz +05:10
ISO_WEEK, ISOWK, ISOWW 44

참고 항목

CAST 및 CONVERT(Transact-SQL)