TODATETIMEOFFSET(Transact-SQL)

아티클
10/16/2024

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

datetime2 표현식에서 변환된 datetimeoffset 값을 반환합니다.

Transact-SQL 구문 규칙

구문

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )

인수

datetime_expression
datetime2 값으로 확인되는 식입니다.

참고

varchar 또는 nvarchar로 암시적으로 변환할 수 없는 text, ntext 또는 image 형식의 식을 사용할 수 없습니다.

timezoneoffset_expression
분(-120과 같은 정수인 경우) 단위나 시간 및 분('+13:00'과 같은 문자열인 경우) 단위의 표준 시간대 오프셋을 나타내는 식입니다. 범위는 +14에서 -14(시간) 사이입니다. 이 식은 지정된 timezoneoffset_expression의 현지 시간으로 해석됩니다.

참고

식이 문자열인 경우 {+|-}TZH:THM 형식이어야 합니다.

반환 형식

datetimeoffset. 소수 자릿수는 datetime_expression 인수와 같습니다.

예제

A. 현재 날짜 및 시간의 표준 시간대 오프셋 변경

다음 예에서는 현재 날짜 및 시간의 표준 시간대 오프셋을 표준 시간대 -07:00으로 변경합니다.

DECLARE @todaysDateTime DATETIME2;  
SET @todaysDateTime = GETDATE();  
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00');  
-- RETURNS 2019-04-22 16:23:51.7666667 -07:00

B. 표준 시간대 오프셋(분) 변경

다음 예에서는 현재 표준 시간대를 -120분으로 변경합니다.

SELECT TODATETIMEOFFSET(SYSDATETIME(), -120)
-- RETURNS: 2019-04-22 11:39:21.6986813 -02:00

C. 13시간 표준 시간대 오프셋 추가

다음 예에서는 날짜 및 시간에 13시간 표준 시간대 오프셋을 추가합니다.

SELECT TODATETIMEOFFSET(SYSDATETIME(), '+13:00')
-- RETURNS: 2019-04-22 11:39:29.0339301 +13:00

참고 항목

CAST 및 CONVERT(Transact-SQL)
날짜 및 시간 데이터 형식 및 함수(Transact-SQL)
AT TIME ZONE(Transact-SQL)

다음을 통해 공유