datetimeoffset(Transact-SQL)

  • 아티클

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

datetime2와 같은 24시간 시계에 따라 하루의 시간과 결합되는 날짜를 정의하고 UTC(유니버설 시간 좌표 또는 그리니치 표준시)를 기반으로 표준 시간대 인식을 추가합니다.

datetimeoffset 설명

속성 값
구문 datetimeoffset [ (fractional seconds precision) ]
사용 DECLARE @MyDatetimeoffset datetimeoffset(7)

CREATE TABLE Table1 ( Column1 datetimeoffset(7) )
기본 문자열 리터럴 형식(하위 수준 클라이언트에 사용) YYYY-MM-DD hh:mm:ss[.nnnnnnn] [{+|-}hh:mm]

자세한 내용은 뒷부분에 나오는 "하위 클라이언트에 대한 이전 버전과의 호환성" 섹션을 참조하세요.
날짜 범위 0001-01-01부터 31.12.99까지

CE 1년 1월 1일부터 CE 9999년 12월 31일까지
시간 범위 00:00:00~23:59:59.99999999
표준 시간대 오프셋 범위 -14:00 ~ +14:00
요소 범위 YYYY는 0001에서 9999 사이에 속하는 4자리 숫자로, 연도를 나타냅니다.

MM은 지정된 연도의 월을 나타내는 01에서 12 사이의 두 자리 숫자입니다.

DD는 지정된 월의 일을 나타내는 달에 따라 01에서 31까지의 두 자리 숫자입니다.

hh는 시간을 나타내는 00에서 23 사이의 두 자리 숫자입니다.

mm은 분을 나타내는 00에서 59 사이의 두 자리입니다.

ss는 두 번째 숫자를 나타내는 00에서 59 사이의 두 자리 숫자입니다.

n*은 0에서 9999999 사이에 속하는 0부터 7 자리의 숫자로, 소수 자릿수 초를 나타냅니다.

hh는 -14에서 +14까지의 두 자리 숫자입니다.

mm은 00에서 59까지의 두 자리 숫자입니다.
문자 길이 최소 26개 위치(YYYY-MM-DD hh:mm:ss {+|-}hh:mm)에서 최대 34개까지(YYYY-MM-DD hh:mm:ss.nnnnnnn {+|-}hh:mm)
전체 자릿수, 소수 자릿수 아래 표를 참조하세요.
스토리지 크기 초 소수 부분 자릿수 기본값 100ns를 기준으로 10바이트(고정)가 기본값입니다.
정확도 100나노초
기본값 1900-01-01 00:00:00 00:00
Calendar 양력
사용자 정의 초 소수 부분 자릿수 예
표준 시간대 오프셋 인식 및 유지 예
일광 절약 시간 인식 아니요
지정한 소수 자릿수 결과(전체 자릿수, 소수 자릿수) 열 길이(바이트) 소수 자릿수 초의 전체 자릿수
datetimeoffset (34,7) 10 7
datetimeoffset(0) (26,0) 8 0-2
datetimeoffset(1) (28,1) 8 0-2
datetimeoffset(2) (29,2) 8 0-2
datetimeoffset(3) (30,3) 9 3~4
datetimeoffset(4) (31,4) 9 3~4
datetimeoffset(5) (32,5) 10 5-7
datetimeoffset(6) (33,6) 10 5-7
datetimeoffset(7) (34,7) 10 5-7

datetimeoffset에 대해 지원되는 문자열 리터럴 형식

다음 표에서는 datetimeoffset에 대해 지원되는 ISO 8601 문자열 리터럴 형식을 나열합니다. datetimeoffset의 날짜 및 시간 부분에 대한 영문자, 숫자, 시간 및 구분되지 않은 시간 형식에 대한 내용은 날짜(Transact-SQL) 및 시간(Transact-SQL)을 참조하세요.

ISO 8601 설명
YYYY-MM-DDThh:mm:ss[.nnnnnnn][{+|-}hh:mm] 이러한 두 형식은 SET LANGUAGE 및 SET DATEFORMAT 세션 로캘 설정의 영향을 받지 않습니다. datetimeoffset과 datetime 부분 사이에는 공백이 허용되지 않습니다.
YYYY-MM-DDThh:mm:ss[.nnnnnnn]Z(UTC) ISO 정의에 따른 이 형식은 datetime 부분이 UTC(Coordinated Universal Time)로 표현되어야 함을 나타냅니다. 예를 들어 1999-12-12 12:30:30.12345 -07:00은 1999-12-12 19:30:30.12345Z로 표현되어야 합니다.

표준 시간대 오프셋

표준 시간대 오프셋은 시간 또는 날짜/시간 값에 대한 UTC의 영역 오프셋을 지정합니다. 표준 시간대 오프셋은 [+|-] hh:mm:으로 나타낼 수 있습니다.

  • hh는 0에서 14 사이에 속하는 두 자리 숫자로, 표준 시간대 오프셋의 시간(시간)을 나타냅니다.
  • mm은 표준 시간대 오프셋의 추가 시간(분)을 나타내는 00에서 59 사이의 두 자리 숫자입니다.
  • +(더하기) 또는 -(빼기)는 표준 시간대 오프셋의 필수 기호입니다. 이는 현지 시간을 가져오기 위해 UTC 시간에서 표준 시간대 오프셋을 더했는지 또는 뺐는지를 나타냅니다. 유효한 표준 시간대 오프셋 범위는 -14:00에서 +14:00까지입니다.

표준 시간대 오프셋 범위는 XSD 스키마 정의에 대한 W3C XML 표준을 따르며 SQL 2003 표준 정의 12:59에서 +14:00까지 약간 다릅니다.

선택적 유형 매개 변수인 초 소수 부분 자릿수는 초의 소수 부분의 자릿수를 지정합니다. 이 값은 0~7(100나노초)의 정수일 수 있습니다. 기본 소수 자릿수 초 정밀도 는 100ns(초의 소수 부분에 대한 7자리 숫자)입니다.

데이터는 데이터베이스에 저장되고 UTC와 같이 서버에서 처리, 비교, 정렬 및 인덱싱됩니다. 검색을 위해 표준 시간대 오프셋이 데이터베이스에 유지됩니다.

지정된 표준 시간대 오프셋은 DST(일광 절약 시간) 인식 및 DST 기간의 지정된 날짜/시간에 맞게 조정된 것으로 간주됩니다.

datetimeoffset 형식의 경우 UTC 및 로컬(영구 또는 변환된 표준 시간대 오프셋에 대한) 날짜/시간 값은 삽입, 업데이트, 산술, 변환 또는 할당 작업 중에 유효성을 검사합니다. 잘못된 UTC 또는 로컬(영구 또는 변환된 표준 시간대 오프셋에 대한) 날짜/시간 값을 검색하면 잘못된 값 오류가 발생합니다. 예를 들어 9999-12-31 10:10:00은 UTC에서 유효하지만 현지 시간으로 표준 시간대 오프셋 +13:50으로 오버플로됩니다.

날짜를 대상 표준 시간대의 해당 datetimeoffset 값으로 변환하려면 AT TIME ZONE(Transact-SQL)을 참조하세요.

ANSI 및 ISO 8601 규정 준수

날짜 및 시간 항목의 ANSI 및 ISO 8601 준수 섹션은 datetimeoffset에 적용됩니다.

하위 수준 클라이언트에 대한 이전 버전과의 호환성

일부 하위 수준 클라이언트는 시간, 날짜, datetime2 및 datetimeoffset 데이터 형식을 지원하지 않습니다. 다음 표에서는 SQL Server의 상위 수준 인스턴스와 하위 수준 클라이언트 간의 형식 매핑을 보여 줍니다.

SQL Server 데이터 형식 하위 수준 클라이언트에 전달되는 기본 문자열 리터럴 형식 하위 수준 ODBC 하위 수준 OLEDB 하위 수준 JDBC 하위 수준 SQLCLIENT
time hh:mm:ss[.nnnnnnn] SQL_WVARCHAR 또는 SQL_VARCHAR DBTYPE_WSTR 또는 DBTYPE_STR Java.sql.String 문자열 또는 SqString
date YYYY-MM-DD SQL_WVARCHAR 또는 SQL_VARCHAR DBTYPE_WSTR 또는 DBTYPE_STR Java.sql.String 문자열 또는 SqString
datetime2 YYYY-MM-DD hh:mm:ss[.nnnnnnn] SQL_WVARCHAR 또는 SQL_VARCHAR DBTYPE_WSTR 또는 DBTYPE_STR Java.sql.String 문자열 또는 SqString
datetimeoffset YYYY-MM-DD hh:mm:ss[.nnnnnnn] [+|-]hh:mm SQL_WVARCHAR 또는 SQL_VARCHAR DBTYPE_WSTR 또는 DBTYPE_STR Java.sql.String 문자열 또는 SqString

날짜 및 시간 데이터 변환

날짜 및 시간 데이터 형식으로 변환할 때 SQL Server는 날짜 또는 시간으로 인식할 수 없는 모든 값을 거부합니다. 날짜 및 시간 데이터에 CAST 및 CONVERT 함수를 사용하는 방법은 CAST 및 CONVERT(Transact-SQL)를 참조하세요.

datetimeoffset 데이터 형식을 다른 날짜 및 시간 형식으로 변환

이 섹션에서는 datetimeoffset 데이터 형식을 다른 날짜 및 시간 데이터 형식으로 변환할 때 발생하는 상황에 대해 설명합니다.

date로 변환하는 경우 년, 월, 일이 복사됩니다. 다음 코드는 값을 값 date 으로 변환한 datetimeoffset(4) 결과를 보여줍니다.

DECLARE @datetimeoffset DATETIMEOFFSET(4) = '12-10-25 12:32:10 +01:00';
DECLARE @date DATE = @datetimeoffset;

SELECT @datetimeoffset AS '@datetimeoffset ', @date AS 'date';

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

@datetimeoffset                 date  
------------------------------ ----------  
2025-12-10 12:32:10.0000 +01:0 2025-12-10

변환이 time(n)이면 시간, 분, 초 및 소수 자릿수 초가 복사됩니다. 표준 시간대 값은 잘립니다. datetimeoffset(n) 값의 전체 자릿수가 time(n) 값의 전체 자릿수보다 크면 값이 반올림됩니다. 다음 코드는 값을 값 time(3) 으로 변환한 datetimeoffset(4) 결과를 보여줍니다.

DECLARE @datetimeoffset DATETIMEOFFSET(4) = '12-10-25 12:32:10.1237 +01:0';
DECLARE @time TIME(3) = @datetimeoffset;

SELECT @datetimeoffset AS '@datetimeoffset ', @time AS 'time';

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

@datetimeoffset                 time  
------------------------------- ------------  
2025-12-10 12:32:10.1237 +01:00 12:32:10.124

datetime으로 변환할때 날짜 및 시간 값이 복사되고 표준 시간대가 잘립니다. datetimeoffset(n) 값의 소수 자릿수가 3자리보다 크면 값이 잘립니다. 다음 코드는 값을 값 datetime 으로 변환한 datetimeoffset(4) 결과를 보여줍니다.

DECLARE @datetimeoffset DATETIMEOFFSET(4) = '12-10-25 12:32:10.1237 +01:0';
DECLARE @datetime DATETIME = @datetimeoffset;

SELECT @datetimeoffset AS '@datetimeoffset ', @datetime AS 'datetime';

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

@datetimeoffset                datetime  
------------------------------ -----------------------  
2025-12-10 12:32:10.1237 +01:0 2025-12-10 12:32:10.123

smalldatetime으로 변환하는 경우 날짜와 시간이 복사됩니다. 초 값에 따라 분이 반올림되고 초가 0으로 설정됩니다. 다음 코드는 값을 값 smalldatetime 으로 변환한 datetimeoffset(3) 결과를 보여줍니다.

DECLARE @datetimeoffset DATETIMEOFFSET(3) = '1912-10-25 12:24:32 +10:0';
DECLARE @smalldatetime SMALLDATETIME = @datetimeoffset;

SELECT @datetimeoffset AS '@datetimeoffset', @smalldatetime AS '@smalldatetime';

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

@datetimeoffset                @smalldatetime  
------------------------------ -----------------------  
1912-10-25 12:24:32.000 +10:00 1912-10-25 12:25:00

datetime2(n)로 변환하면 날짜와 시간이 datetime2 값으로 복사되고 표준 시간대가 잘립니다. datetime2(n) 값의 전체 자릿수가 datetimeoffset(n) 값의 전체 자릿수보다 크면 소수 자릿수 초가 잘립니다. 다음 코드는 값을 값 datetime2(3) 으로 변환한 datetimeoffset(4) 결과를 보여줍니다.

DECLARE @datetimeoffset DATETIMEOFFSET(4) = '1912-10-25 12:24:32.1277 +10:0';
DECLARE @datetime2 DATETIME2(3) = @datetimeoffset;

SELECT @datetimeoffset AS '@datetimeoffset', @datetime2 AS '@datetime2';

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

@datetimeoffset                    @datetime2  
---------------------------------- ----------------------  
1912-10-25 12:24:32.1277 +10:00    1912-10-25 12:24:32.12

문자열 리터럴을 datetimeoffset으로 변환

문자열의 모든 부분이 유효한 형식인 경우 문자열 리터럴에서 날짜 및 시간 형식으로 변환할 수 있습니다. 그렇지 않으면 런타임 오류가 발생합니다. 날짜/시간 유형에서 문자열 리터럴로의 암시적 변환 또는 명시적 변환에 스타일을 지정하지 않은 경우 현재 세션의 기본 형식이 지정됩니다. 다음 표에서는 문자열 리터럴을 datetimeoffset 데이터 형식으로 변환하는 규칙을 보여 줍니다.

입력 문자열 리터럴 datetimeoffset(n)
ODBC 날짜 ODBC 문자열 리터럴은 datetime 데이터 형식에 매핑됩니다. ODBC DATETIME 리터럴에서 datetimeoffset 형식으로 할당 작업을 수행하면 변환 규칙에 정의된 대로 datetime과 이 형식 간에 암시적 변환이 발생합니다.
ODBC 시간 이전 ODBC DATE 규칙을 참조하세요.
ODBC DATETIME 이전 ODBC DATE 규칙을 참조하세요.
날짜만 TIME 파트의 기본값은 00:00:00입니다. TIMEZONE의 기본값은 +00:00입니다.
TIME만 DATE 부분은 기본적으로 1900-1-1로 설정됩니다. 표준 시간대는 기본적으로 +00:00입니다.
표준 시간대만 기본값이 제공됩니다.
날짜 + 시간 TIMEZONE의 기본값은 +00:00입니다.
날짜 + 표준 시간대 허용되지 않음
TIME+TIMEZONE DATE 부분은 기본적으로 1900-1-1로 설정됩니다.
DATE+TIME+TIMEZONE 중요하지 않음

예제

다음 예제에서는 각 날짜 및 시간 데이터 형식에 문자열을 캐스팅한 결과를 비교합니다.

SELECT CAST('2007-05-08 12:35:29. 1234567 +12:15' AS TIME(7)) AS 'time',
    CAST('2007-05-08 12:35:29. 1234567 +12:15' AS DATE) AS 'date',
    CAST('2007-05-08 12:35:29.123' AS SMALLDATETIME) AS 'smalldatetime',
    CAST('2007-05-08 12:35:29.123' AS DATETIME) AS 'datetime',
    CAST('2007-05-08 12:35:29.1234567+12:15' AS DATETIME2(7)) AS 'datetime2',
    CAST('2007-05-08 12:35:29.1234567 +12:15' AS DATETIMEOFFSET(7)) AS 'datetimeoffset',
    CAST('2007-05-08 12:35:29.1234567+12:15' AS DATETIMEOFFSET(7)) AS 'datetimeoffset IS08601';

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

데이터 형식 출력
Time 12:35:29. 1234567
날짜 2007-05-08
Smalldatetime 2007-05-08 12:35:00
Datetime 2007-05-08 12:35:29.123
datetime2 2007-05-08 12:35:29. 1234567
Datetimeoffset 2007-05-08 12:35:29.1234567 +12:15

참고 항목

CAST 및 CONVERT(Transact-SQL)
AT TIME ZONE(Transact-SQL)