タイムゾーン (Transact-SQL)

適用対象:Sql Server 2016 (13.x) 以降のバージョンAzure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Microsoft Fabric の AzureSQL 分析エンドポイント Microsoft Fabric のウェアハウス Microsoft Fabric のSQL データベース

AT TIME ZONE Transact-SQL(T-SQL)文は、input_dateをターゲットタイムゾーンの対応するdatetimeoffset値に変換します。オフセット情報なしで提供される input_date 、関数は input_date が目標タイムゾーンにあると仮定してそのタイムゾーンのオフセットを適用します。

input_dateがdatetimeoffset値として提供されている場合、節AT TIME ZONEタイムゾーン変換ルールを使って目標タイムゾーンに変換されます。

AT TIME ZONE実装は、datetimeの値をタイムゾーン間で変換するためのWindowsメカニズムに依存しています。

Transact-SQL 構文表記規則

Syntax

input_date AT TIME ZONE time_zone_value

input_date AT TIME ZONE { 'time_zone_value' | 'LOCAL' }

Arguments

input_date

smalldatetime、datetime、datetime2、datetimeoffset 値に解決できる式。

「time_zone_value」

変換先のタイムゾーンの名前。 time_zone_value は nvarchar(128)です。

SQL Server は Windows レジストリに格納されているタイムゾーンに依存します。コンピューターにインストールされているタイムゾーンは、次のレジストリハイブに格納されています: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。

インストールされたタイムゾーンのリストも sys.time_zone_info システムビューで公開されます。

SQL Server on Linux のタイムゾーンの詳細については、「Linux 上の SQL Server 2022 以降のバージョンのタイムゾーンを構成する」を参照してください。

{ 'time_zone_value' |'ローカル'}

変換先のタイムゾーンの名前。 time_zone_value は nvarchar(128)で、デフォルトは LOCALです。

インストールされたタイムゾーンのリストが sys.time_zone_info システムビューで公開されます。

LOCALが指定されている場合、セッションの現在のデフォルトタイムゾーン値は元のセッションのタイムゾーン値に設定され、これはデータベースのスコープオプションまたはインスタンスのデフォルトのいずれかです。

戻り値の型

datetimeoffset のデータ型を返します。

戻り値

変換先のタイムゾーンの datetimeoffset 値。

Remarks

AT TIME ZONE は、データ型 smalldatetime、datetime、datetime2 の入力値が DST 変更の影響を受ける時間間隔に分類されるとき、特別な入力値変換ルールを適用します。

時計が進んでいると、現地時刻には時計調整の継続時間と等しい隔たりが存在します。この継続時間は通常は 1 時間ですが、タイムゾーンによっては 30 分または 45 分の場合もあります。 DST 変更の "後" で、この隔たり内にある時点はオフセットで変換されます。

/*
  Moving to DST in "Central European Standard Time" zone:
  offset changes from +01:00 -> +02:00
  Change occurred on March 27th, 2022 at 02:00:00.
  Adjusted local time became 2022-03-27 03:00:00.
*/

--Time before DST change has standard time offset (+01:00)
SELECT CONVERT (DATETIME2 (0), '2022-03-27T01:01:00', 126)
    AT TIME ZONE 'Central European Standard Time';

--Result: 2022-03-27 01:01:00 +01:00
/*
  Adjusted time from the "gap interval" (between 02:00 and 03:00)
  is moved 1 hour ahead and presented with the summer time offset
  (after the DST change)
*/
SELECT CONVERT (DATETIME2 (0), '2022-03-27T02:01:00', 126)
    AT TIME ZONE 'Central European Standard Time';

--Result: 2022-03-27 03:01:00 +02:00

--Time after 03:00 is presented with the summer time offset (+02:00)
SELECT CONVERT (DATETIME2 (0), '2022-03-27T03:01:00', 126)
    AT TIME ZONE 'Central European Standard Time';

--Result: 2022-03-27 03:01:00 +02:00

時計が遅れていると、現地時刻の 2 時間が重なり、1 時間になります。その場合、時計変更の前に、重なる時間間隔に属する時点がオフセットで表されます。

/*
    Moving back from DST to standard time in
    "Central European Standard Time" zone:
    offset changes from +02:00 -> +01:00.
    Change occurred on October 30th, 2022 at 03:00:00.
    Adjusted local time became 2022-10-30 02:00:00
*/

--Time before the change has DST offset (+02:00)
SELECT CONVERT (DATETIME2 (0), '2022-10-30T01:01:00', 126)
    AT TIME ZONE 'Central European Standard Time';

--Result: 2022-10-30 01:01:00 +02:00
/*
  Time from the "overlapped interval" is presented with DST offset (before the change)
*/
SELECT CONVERT (DATETIME2 (0), '2022-10-30T02:00:00', 126)
    AT TIME ZONE 'Central European Standard Time';

--Result: 2022-10-30 02:00:00 +02:00

--Time after 03:00 is regularly presented with the standard time offset (+01:00)
SELECT CONVERT (DATETIME2 (0), '2022-10-30T03:01:00', 126)
    AT TIME ZONE 'Central European Standard Time';

--Result: 2022-10-30 03:01:00 +01:00

一部の情報 (タイムゾーンルールなど) は SQL Server の外で保守管理され、時折変更されるため、AT TIME ZONE 関数は非決定的として分類されます。

datetimeoffsetは Microsoft Fabric のデータウェアハウスではサポートされていませんが、次の例のように、AT TIME ZONEは引き続き datetime2 で使用できます。

Examples

A. オフセット情報なしで、変換先のタイムゾーンのオフセットを datetime に追加する

元の AT TIME ZONE 値が同じタイムゾーンで与えられることがわかっているとき、タイムゾーンルールに基づいてオフセットを追加するには、を使用します。

USE AdventureWorks2025;
GO

SELECT SalesOrderID,
       OrderDate,
       OrderDate AT TIME ZONE 'Pacific Standard Time' AS OrderDate_TimeZonePST
FROM Sales.SalesOrderHeader;

結果セットは次のとおりです。

SalesOrderID OrderDate               OrderDate_TimeZonePST
------------ ----------------------- -------------------------------
43659        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00
43660        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00
43661        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00
43662        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00
43663        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00
43664        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00
...

B. 異なるタイムゾーン間で値を変換する

次の例では、異なるタイムゾーン間で値を変換します。 OrderDate値は datetime オフセットと共に格納されませんが、太平洋標準時と呼ばれます。最初の手順では、既知のオフセットを割り当ててから、新しいタイムゾーンに変換します。

USE AdventureWorks2025;
GO

SELECT SalesOrderID,
       OrderDate,
       --Assign the known offset only
       OrderDate AT TIME ZONE 'Pacific Standard Time' AS OrderDate_TimeZonePST,
       --Assign the known offset, then convert to another time zone
       OrderDate AT TIME ZONE 'Pacific Standard Time' AT TIME ZONE 'Central European Standard Time' AS OrderDate_TimeZoneCET
FROM Sales.SalesOrderHeader;

結果セットは次のとおりです。

SalesOrderID OrderDate               OrderDate_TimeZonePST          OrderDate_TimeZoneCET
------------ ----------------------- ------------------------------ -------------------------------
43659        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43660        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43661        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43662        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43663        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43664        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
...

タイムゾーンを含むローカル変数に置き換えることもできます。

USE AdventureWorks2025;
GO

DECLARE @CustomerTimeZone AS NVARCHAR (128) = 'Central European Standard Time';

SELECT SalesOrderID,
       OrderDate,
       --Assign the known offset only
       OrderDate AT TIME ZONE 'Pacific Standard Time' AS OrderDate_TimeZonePST,
       --Assign the known offset, then convert to another time zone
       OrderDate AT TIME ZONE 'Pacific Standard Time' AT TIME ZONE @CustomerTimeZone AS OrderDate_TimeZoneCustomer
FROM Sales.SalesOrderHeader;

結果セットは次のとおりです。

SalesOrderID OrderDate               OrderDate_TimeZonePST          OrderDate_TimeZoneCustomer
------------ ----------------------- ------------------------------ -------------------------------
43659        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43660        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43661        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43662        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43663        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
43664        2022-05-30 00:00:00.000 2022-05-30 00:00:00.000 -07:00 2022-05-30 09:00:00.000 +02:00
...

C. 特定のタイムゾーンを使用して、テンポラルテーブルに対してクエリを実行する

以下の例は、太平洋標準時を用いて WideWorldImporters の時間表からデータを選択します。

USE WideWorldImporters;
GO

DECLARE @ASOF AS DATETIMEOFFSET;
SET @ASOF = DATEADD(MONTH, -1, GETDATE()) AT TIME ZONE 'UTC';

-- Query state of the table a month ago projecting period
-- columns as Pacific Standard Time
SELECT CustomerID,
       CustomerName,
       ValidFrom AT TIME ZONE 'Pacific Standard Time'
FROM Sales.Customers FOR SYSTEM_TIME AS OF @ASOF;

結果セットは次のとおりです。

CustomerID CustomerName                        ValidFrom
---------- ----------------------------------- ----------------------------------
1          Tailspin Toys (Head Office)         2013-01-01 00:00:00.0000000 -08:00
2          Tailspin Toys (Sylvanite, MT)       2013-01-01 00:00:00.0000000 -08:00
3          Tailspin Toys (Peeples Valley, AZ)  2013-01-01 00:00:00.0000000 -08:00
4          Tailspin Toys (Medicine Lodge, KS)  2013-01-01 00:00:00.0000000 -08:00
5          Tailspin Toys (Gasport, NY)         2013-01-01 00:00:00.0000000 -08:00
6          Tailspin Toys (Jessie, ND)          2013-01-01 00:00:00.0000000 -08:00

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-09-29

タイム ゾーン (Transact-SQL)

Syntax

Arguments

input_date

「time_zone_value」

{ 'time_zone_value' |'ローカル'}

戻り値の型

戻り値

Remarks

Examples

A. オフセット情報なしで、変換先のタイム ゾーンのオフセットを datetime に追加する

B. 異なるタイム ゾーン間で値を変換する

C. 特定のタイム ゾーンを使用して、テンポラル テーブルに対してクエリを実行する

関連コンテンツ

フィードバック

その他のリソース

タイムゾーン (Transact-SQL)

A. オフセット情報なしで、変換先のタイムゾーンのオフセットを datetime に追加する

B. 異なるタイムゾーン間で値を変換する

C. 特定のタイムゾーンを使用して、テンポラルテーブルに対してクエリを実行する