カテゴリ：: 日付と時刻の関数

CONVERT_TIMEZONE¶

タイムスタンプを別のタイムゾーンに変換します。

構文¶

CONVERT_TIMEZONE( <source_tz> , <target_tz> , <source_timestamp_ntz> )

CONVERT_TIMEZONE( <target_tz> , <source_timestamp> )

引数¶

source_tz: 入力タイムスタンプのタイムゾーンを指定する文字列です。タイムゾーンのないタイムスタンプに必要です（つまり、 TIMESTAMP_NTZ）。
target_tz: 入力タイムスタンプの変換先のタイムゾーンを指定する文字列です。
source_timestamp_ntz: 3引数バージョンで、変換するタイムスタンプを指定する文字列です（TIMESTAMP_NTZにする必要があります）。
source_timestamp: 2引数バージョンで、変換するタイムスタンプを指定する文字列です（ TIMESTAMP_NTZを含む任意のタイムスタンプバリアントです）。

戻り値¶

型 TIMESTAMP_NTZ、 TIMESTAMP_TZ、または NULL の値を返します。

3引数バージョンでは、 TIMESTAMP_NTZ 型の値を返します。
2引数バージョンでは、 TIMESTAMP_TZ 型の値を返します。
いずれかの引数が NULL の場合、 NULL を返します。

使用上の注意¶

出力のタイムスタンプの表示形式は、現在のセッションのタイムスタンプ出力形式と返されるタイムスタンプ値のデータ型によって決定されます。
3引数バージョンの場合、結果の「wallclock」時間（現実世界の経過時間）は、入力タイムゾーンの入力「wallclock」と同じ時間を表しますが、ターゲット先のタイムゾーンにあります。
2引数バージョンの場合、 source_timestamp 引数には通常タイムゾーンが含まれます。値が TIMESTAMP_TZ型の場合、タイムゾーンはその値から取得されます。それ以外の場合は、現在のセッションのタイムゾーンが使用されます。
source_tz と target_tz の場合は、 IANA タイムゾーンデータベースのリリース 2025b からタイムゾーン名またはリンク名を指定できます（例: America/Los_Angeles、 Europe/London、 UTC、 Etc/GMT など）。
注釈
- タイムゾーン名は大文字と小文字が区別され、一重引用符で囲む必要があります（例： 'UTC'）。
- Snowflakeは、タイムゾーンの略語の大半をサポートしていません（例: PDT、 EST）。特定の略語は、いくつかの異なるタイムゾーンの1つを参照している可能性があるためです。たとえば、 CST は、北米の中部標準時（UTC-6）、キューバ標準時（UTC-5）、および中国標準時（UTC+8）を指す場合があります。

例¶

例で返されるタイムスタンプにデフォルトのタイムスタンプ出力フォーマットを使用するには、現在のセッションで TIMESTAMP_OUTPUT_FORMAT パラメーターの設定を解除します。

ALTER SESSION UNSET TIMESTAMP_OUTPUT_FORMAT;

ソースタイムゾーンを指定する例¶

以下の例では、 CONVERT_TIMEZONE 関数の3引数バージョンを使用し、 source_tz 値を指定しています。これらの例は TIMESTAMP_NTZ 値を返します。

ロサンゼルスの「wallclock」時間をニューヨークの「wallclock」時間に変換します。

SELECT CONVERT_TIMEZONE(
  'America/Los_Angeles',
  'America/New_York',
  '2024-01-01 14:00:00'::TIMESTAMP_NTZ
) AS conv;

+-------------------------+
| CONV                    |
|-------------------------|
| 2024-01-01 17:00:00.000 |
+-------------------------+

ワルシャワの「wallclock」時間を UTC で一致する「wallclock」時間に変換します。

SELECT CONVERT_TIMEZONE(
  'Europe/Warsaw',
  'UTC',
  '2024-01-01 00:00:00'::TIMESTAMP_NTZ
) AS conv;

+-------------------------+
| CONV                    |
|-------------------------|
| 2023-12-31 23:00:00.000 |
+-------------------------+

送信元のタイムゾーンを指定しない例¶

以下の例では、 CONVERT_TIMEZONE 関数の2引数バージョンを使用しています。これらの例は TIMESTAMP_TZ 値を返します。したがって、返される値には、タイムスタンプのタイムゾーンと協定世界時（UTC）との差を示すオフセットが含まれます。例えば、 America/Los_Angeles タイムゾーンは、 -0700 のオフセットがあり、 UTC から7時間遅れていることを示します。

TIMESTAMP_TZ 値を指定する文字列を異なるタイムゾーンに変換します。

SELECT CONVERT_TIMEZONE(
  'America/Los_Angeles',
  '2024-04-05 12:00:00 +02:00'
) AS time_in_la;

+-------------------------------+
| TIME_IN_LA                    |
|-------------------------------|
| 2024-04-05 03:00:00.000 -0700 |
+-------------------------------+

異なるタイムゾーンにおける現在の「wallclock」時間を表示します。

SELECT
  CURRENT_TIMESTAMP() AS now_in_la,
  CONVERT_TIMEZONE('America/New_York', CURRENT_TIMESTAMP()) AS now_in_nyc,
  CONVERT_TIMEZONE('Europe/Paris', CURRENT_TIMESTAMP()) AS now_in_paris,
  CONVERT_TIMEZONE('Asia/Tokyo', CURRENT_TIMESTAMP()) AS now_in_tokyo;

+-------------------------------+-------------------------------+-------------------------------+-------------------------------+
| NOW_IN_LA                     | NOW_IN_NYC                    | NOW_IN_PARIS                  | NOW_IN_TOKYO                  |
|-------------------------------+-------------------------------+-------------------------------+-------------------------------|
| 2024-06-12 08:52:53.114 -0700 | 2024-06-12 11:52:53.114 -0400 | 2024-06-12 17:52:53.114 +0200 | 2024-06-13 00:52:53.114 +0900 |
+-------------------------------+-------------------------------+-------------------------------+-------------------------------+