적용 대상:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsMicrosoft Fabric의 SQL 데이터베이스
이 문서의 섹션에서는 모든 Transact-SQL 날짜 및 시간 데이터 형식과 함수를 다룹니다.
날짜 및 시간 데이터 형식
다음 표에 Transact-SQL의 날짜 및 시간 데이터 형식이 나와 있습니다.
| 데이터 형식 |
서식 |
범위 |
정확도 |
스토리지 크기(바이트) |
사용자 정의 초 소수 부분 자릿수 |
표준 시간대 오프셋 |
|
time |
HH:mm:ss[.nnnnnnn] |
00:00:00.0000000부터 23:59:59.9999999까지 |
100나노초 |
3 ~ 5 |
Yes |
예 |
|
date |
yyyy-MM-dd |
0001-01-01부터 31.12.99까지 |
1일 |
3 |
예 |
예 |
|
smalldatetime |
이이이-음-dd HH:음:ss |
1900-01-01부터 2079-06-06까지 |
1분 |
4 |
예 |
예 |
|
datetime |
yyyy-mm-dd HH:mm:ss[.nnn] |
1753-01-01부터 9999-12-31까지 |
0.00333초 |
8 |
예 |
예 |
|
datetime2 |
yyyy-mm-dd HH:mm:ss[.nnnnnnn] |
0001-01-01 00:00:00.0000000부터 9999-12-31 23:59:59.9999999까지 |
100나노초 |
6 ~ 8 |
Yes |
예 |
|
datetimeoffset |
yyyy-mm-dd HH:mm:ss[.nnnnnnn] [+|-]HH:mm |
0001-01-01 00:00:00.0000000부터 9999-12-31 23:59:59.9999999까지(UTC) |
100나노초 |
8 ~ 10 |
Yes |
Yes |
참고 항목
Transact-SQL rowversion 데이터 형식은 날짜 또는 시간 데이터 형식이 아닙니다.
timestamp는 rowversion에 사용되지 않는 동의어입니다.
날짜 및 시간 함수
다음 표에서는 Transact-SQL 날짜 및 시간 함수를 나열합니다. 결정성에 대한 자세한 내용은 결정적 함수 및 비결정적 함수를 참조하세요.
시스템 날짜 및 시간 값을 반환하는 함수
Transact-SQL은 모든 시스템 날짜 및 시간 값을 SQL Server 인스턴스가 실행 중인 컴퓨터 운영 체제에서 가져옵니다.
정밀도가 높은 시스템 날짜 및 시간 함수
SQL Server 2008(10.0.x)에서부터 데이터베이스 엔진은 GetSystemTimeAsFileTime() Windows API를 사용하여 날짜 및 시간 값을 가져옵니다. 정확도는 SQL Server 인스턴스가 실행되고 있는 컴퓨터의 하드웨어와 Windows 버전에 따라 달라집니다. 이 API의 정밀도는 100나노초에 고정되어 있습니다. 정확도를 확인하려면 GetSystemTimeAdjustment() Windows API를 사용합니다.
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
SYSDATETIME |
SYSDATETIME ( ) |
SQL Server 인스턴스가 실행되고 있는 컴퓨터의 날짜와 시간이 포함된 datetime2(7) 값을 반환합니다. 반환 값에는 표준 시간대 오프셋이 포함되지 않습니다. |
datetime2(7) |
비결정적 |
|
SYSDATETIMEOFFSET |
SYSDATETIMEOFFSET ( ) |
SQL Server 인스턴스가 실행되고 있는 컴퓨터의 날짜와 시간이 포함된 datetimeoffset(7) 값을 반환합니다. 반환 값에는 표준 시간대 오프셋이 포함됩니다. |
datetimeoffset(7) |
비결정적 |
|
SYSUTCDATETIME |
SYSUTCDATETIME ( ) |
SQL Server 인스턴스가 실행되고 있는 컴퓨터의 날짜와 시간이 포함된 datetime2(7) 값을 반환합니다. 함수는 날짜와 시간 값을 UTC 시간(Coordinated Universal Time)으로 반환합니다. |
datetime2(7) |
비결정적 |
정밀도가 낮은 시스템 날짜 및 시간 함수
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
CURRENT_TIMESTAMP |
CURRENT_TIMESTAMP |
SQL Server 인스턴스가 실행되고 있는 컴퓨터의 날짜와 시간이 포함된 datetime 값을 반환합니다. 반환 값에는 표준 시간대 오프셋이 포함되지 않습니다. |
datetime |
비결정적 |
|
GETDATE |
게이트 ( ) |
SQL Server 인스턴스가 실행되고 있는 컴퓨터의 날짜와 시간이 포함된 datetime 값을 반환합니다. 반환 값에는 표준 시간대 오프셋이 포함되지 않습니다. |
datetime |
비결정적 |
|
GETUTCDATE |
게투크데이트 ( ) |
SQL Server 인스턴스가 실행되고 있는 컴퓨터의 날짜와 시간이 포함된 datetime 값을 반환합니다. 함수는 날짜와 시간 값을 UTC 시간(Coordinated Universal Time)으로 반환합니다. |
datetime |
비결정적 |
|
CURRENT_DATE |
CURRENT_DATE |
데이터베이스 엔진 인스턴스가 실행되는 컴퓨터의 날짜만 포함하는 날짜 값을 반환합니다. 반환된 값에는 시간 및 표준 시간대 오프셋이 포함되지 않습니다. |
date |
비결정적 |
날짜 및 시간 부분을 반환하는 함수
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
DATE_BUCKET |
DATE_BUCKET ( 날짜 부분, 번호, 날짜, 출신 ) |
origin 매개 변수로 정의된 타임스탬프에서 각 날짜-시간 버킷의 시작에 해당하는 값을 반환하거나, origin 매개 변수가 지정되지 않은 경우 기본 원본 값 1900-01-01 00:00:00.000을 반환합니다. |
반환 형식은 date에 제공된 인수의 따라 달라집니다. |
비결정적 |
|
DATENAME |
DATENAME ( datepart, date ) |
지정한 날짜에서 특정 datepart를 나타내는 문자열을 반환합니다. |
nvarchar |
비결정적 |
|
DATEPART |
DATEPART ( datepart, date ) |
지정한 date에서 특정 datepart를 나타내는 정수를 반환합니다. |
int |
비결정적 |
|
DATETRUNC |
DATETRUNC( datepart, date ) |
지정된 datepart로 잘린 입력 날짜를 반환합니다. |
반환 형식은 date에 제공된 인수의 따라 달라집니다. |
비결정적 |
|
DAY |
DAY ( 날짜 ) |
지정한 date에서 일 부분을 나타내는 정수를 반환합니다. |
int |
명확함 |
|
MONTH |
월 ( 날짜 ) |
지정한 date에서 월 부분을 나타내는 정수를 반환합니다. |
int |
명확함 |
|
YEAR |
연도 ( 날짜 ) |
지정한 date에서 연도 부분을 나타내는 정수를 반환합니다. |
int |
명확함 |
해당 부분에서 날짜 및 시간 값을 반환하는 함수
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
DATEFROMPARTS |
DATEFROMPARTS ( 연도, 월, 요일 ) |
지정된 년, 월, 일에 대한 date 값을 반환합니다. |
date |
명확함 |
|
DATETIME2FROMPARTS |
DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision) |
지정된 전체 자릿수를 사용하여 지정된 날짜 및 시간에 대한 datetime2 값을 반환합니다. |
datetime2(precision) |
명확함 |
|
DATETIMEFROMPARTS |
DATETIMEFROMPARTS ( year, month, day, hour, minute, seconds, milliseconds) |
지정된 날짜 및 시간에 대한 datetime 값을 반환합니다. |
datetime |
명확함 |
|
DATETIMEOFFSETFROMPARTS |
DATETIMEOFFSETFROMPARTS ( year, month, day, hour, minute, seconds, fractions, hour_offset, minute_offset, precision) |
지정된 오프셋 및 전체 자릿수를 사용하여 지정된 날짜 및 시간에 대한 datetimeoffset 값을 반환합니다. |
datetimeoffset(precision) |
명확함 |
|
SMALLDATETIMEFROMPARTS |
SMALLDATETIMEFROMPARTS ( 연도, 월, 일, 시, 분 ) |
지정된 날짜 및 시간에 대한 smalldatetime 값을 반환합니다. |
smalldatetime |
명확함 |
|
TIMEFROMPARTS |
TIMEFROMPARTS (시간, 분, 초, 분수, 정밀도) |
지정한 전체 자릿수를 사용하여 지정한 시간에 대한 time 값을 반환합니다. |
time(precision) |
명확함 |
날짜 및 시간 차이 값을 반환하는 함수
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
DATEDIFF |
DATEDIFF ( datepart, startdate, enddate ) |
지정된 두 날짜 간에 교차되는 날짜 또는 시간 datepart 경계의 수를 반환합니다. |
int |
명확함 |
|
DATEDIFF_BIG |
DATEDIFF_BIG ( 날짜 부분, 시작일, 종료일 ) |
지정된 두 날짜 간에 교차되는 날짜 또는 시간 datepart 경계의 수를 반환합니다. |
bigint |
명확함 |
날짜 및 시간 값을 수정하는 함수
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
DATEADD |
DATEADD (datepart, number, date ) |
지정된 date의 지정된 datepart에 간격을 더하여 새 datetime 값을 반환합니다. |
date 인수의 데이터 형식 |
명확함 |
|
EOMONTH |
EOMONTH ( start_date [, month_to_add ] ) |
선택 사항인 오프셋 옵션을 사용하여 지정한 날짜가 포함된 달의 마지막 날을 반환합니다. |
반환 유형은 start_date 인수 형식이거나 date 데이터 형식입니다. |
명확함 |
|
SWITCHOFFSET |
SWITCHOFFSET (DATETIMEOFFSET, time_zone) |
SWITCHOFFSET은 DATETIMEOFFSET 값의 표준 시간대 오프셋을 변경하고 UTC 값을 유지합니다. |
datetimeoffset을 DATETIMEOFFSET의 소수 자릿수로 표시 |
명확함 |
|
TODATETIMEOFFSET |
TODATETIMEOFFSET (expression, time_zone) |
TODATETIMEOFFSET은 datetime2 값을 datetimeoffset 값으로 변환합니다.
TODATETIMEOFFSET은 datetime2 값을 지정된 time_zone의 현지 시간으로 해석합니다. |
datetimeoffset을 datetime 인수의 소수 자릿수로 표시 |
명확함 |
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
@@DATEFIRST |
@@DATEFIRST |
세션에 대한 SET DATEFIRST의 현재 값을 반환합니다. |
tinyint |
비결정적 |
|
날짜 우선 설정 |
SET DATEFIRST { number | @number_var } |
일주일의 시작 요일을 1부터 7까지의 숫자로 설정합니다. |
해당 없음 |
해당 없음 |
|
날짜 형식 설정 |
SET DATEFORMAT { format | @format_var } |
datetime 또는 smalldatetime 데이터를 입력할 때 날짜 부분의 순서(월/일/년도)를 설정합니다. |
해당 없음 |
해당 없음 |
|
@@LANGUAGE |
@@LANGUAGE |
현재 사용 중인 언어의 이름을 반환합니다. @@LANGUAGE는 날짜 또는 시간 함수가 아닙니다. 하지만 언어 설정은 날짜 함수의 출력에 영향을 줄 수 있습니다. |
해당 없음 |
해당 없음 |
|
집합 언어 |
SET LANGUAGE { [ N ] 'language' | @language_var } |
세션 및 시스템 메시지에 대한 언어 환경을 설정합니다. SET LANGUAGE는 날짜 또는 시간 함수가 아닙니다. 하지만 언어 설정은 날짜 함수의 출력에 영향을 줍니다. |
해당 없음 |
해당 없음 |
|
sp_helplanguage |
sp_helplanguage [ [ @language = ] '언어' ] |
지원되는 모든 언어의 날짜 형식에 대한 정보를 반환합니다.
sp_helplanguage 날짜 또는 시간 저장 프로시저가 아닙니다. 하지만 언어 설정은 날짜 함수의 출력에 영향을 줍니다. |
해당 없음 |
해당 없음 |
날짜 및 시간 값 유효성 검사 함수
| 함수 |
구문 |
반환 값 |
반환 데이터 형식 |
결정성 |
|
ISDATE |
ISDATE ( 표현 식) |
datetime 또는 smalldatetime 입력 식이 유효한 날짜 또는 시간 값인지 여부를 확인합니다. |
int |
ISDATE는 CONVERT 함수와 함께 사용되고 CONVERT 스타일 매개 변수가 지정되고 스타일이 0, 100, 9 또는 109가 아닌 경우에만 결정적입니다. |
날짜 및 시간 관련 문서
| 아티클 |
Description |
|
FORMAT |
지정된 형식 및 선택적 culture로 서식이 지정된 값을 반환합니다. 날짜/시간 및 숫자 값을 문자열로 지정하는 로캘 인식 서식 지정에 FORMAT 함수를 사용합니다. |
|
CAST 및 CONVERT |
문자열 리터럴과 다른 날짜 및 시간 형식 간의 날짜/시간 값 변환에 대한 정보를 제공합니다. |
|
국가별 Transact-SQL 문 작성 |
Transact-SQL 문을 사용하거나 여러 언어를 지원하는 데이터베이스 및 데이터베이스 애플리케이션의 언어 간 이식성에 대한 지침을 제공합니다. |
|
ODBC 스칼라 함수 |
Transact-SQL 문에서 사용할 수 있는 ODBC 스칼라 함수에 대한 정보를 제공합니다. ODBC 날짜 및 시간 함수를 포함합니다. |
|
시간대에서 |
표준 시간대 변환 기능을 제공합니다. |
관련 콘텐츠