SET TIME ZONE

適用対象: Databricks SQL Databricks Runtime

現在のセッションのタイム ゾーンを設定します。

構文

SET TIME ZONE { LOCAL | time_zone_value | INTERVAL interval_literal }

パラメーター

• LOCAL

  タイム ゾーンを、Java の user.timezone プロパティで指定したもの、または user.timezone が未定義の場合は環境変数 TZ、またはそのどちらも未定義の場合はシステム タイム ゾーンに設定します。

• timezone_value

  STRING リテラル。 リージョン ベースのゾーン ID またはゾーン オフセットのいずれかの形式のセッション ローカル タイムゾーンの ID。 リージョンの ID には、'America/Los_Angeles' などの 'area/city' という形式が必要です。 ゾーン オフセットは、'(+|-)HH'、'(+|-)HH:mm' または '(+|-)HH:mm:ss' の形式である必要があります (例: '-08'、'+01:00'、'-13:33:33')。 また、'UTC' と 'Z' は '+00:00' のエイリアスとしてもサポートされています。 他の短い名前はあいまいになる可能性があるため、使用はお勧めしません。

• interval リテラル

  interval リテラルは、セッション タイム ゾーンと 'UTC' の差を表します。 [-18, 18] の範囲の時間で、最大で秒の有効桁数にする必要があります (例: INTERVAL 2 HOURS 30 MINUTES または INTERVAL '15:40:32' HOUR TO SECOND)。

例

-- Set time zone to the system default.
> SET TIME ZONE LOCAL;

-- Set time zone to the region-based zone ID.
> SET TIME ZONE 'America/Los_Angeles';

-- Set time zone to the Zone offset.
> SET TIME ZONE '+08:00';

-- Set time zone with intervals.
> SET TIME ZONE INTERVAL 1 HOUR 30 MINUTES;
> SET TIME ZONE INTERVAL '08:30:00' HOUR TO SECOND;

関連記事

• SET