TODATETIMEOFFSET (Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

返します、 datetimeoffset 値から変換されたです、 datetime2 式です。

Transact-SQL 構文表記規則

構文

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )  

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

datetime_expression
datetime2 値に解決される式です。

Note

型の式をすることはできません テキスト, 、ntext, 、または イメージ に、これらの型を暗黙的に変換できないため varchar または nvarcharです。

timezoneoffset_expression
タイム ゾーン オフセットを表す式です。たとえば、分単位で表す式 (整数の場合) は -120、時間と分単位で表す式 (文字列の場合) は '+13:00' です。 範囲は +14 ～ -14 (時間) です。 式は、指定された timezoneoffset_expression のローカル時刻で解釈されます。

Note

式が文字列の場合、{+|-}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)