TODATETIMEOFFSET (Transact-SQL)
適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
返します、 datetimeoffset 値から変換されたです、 datetime2 式です。
構文
TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )
引数
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)