設定時區

  • 發行項

適用于：核取標示為是 Databricks SQL 檢查標示為是 Databricks Runtime

設定目前會話的時區。

語法

SET TIME ZONE { LOCAL | time_zone_value | INTERVAL interval_literal }

參數

  • 當地

    將時區設定為 java user.timezone 屬性中指定的時區，如果 user.timezone 未定義，則設定為環境變數 TZ ，如果兩者都未定義，則設定為系統時區。

  • timezone_value

    STRING 常值。 會話本機時區的識別碼，格式為區域識別碼或區域位移。 區域識別碼的格式必須是 'area/city'，例如 'America/Los_Angeles'。 區域位移的格式必須是 ' (+|-)HH '、' (+|-)HH:mm ' 或 ' (+|-)HH:mm:ss '，例如 '-08'、'+01：00' 或 '-13：33：33'。 此外，'UTC' 和 'Z' 也支援為 '+00：00' 的別名。 不建議使用其他簡短名稱，因為它們可能模棱兩可。

  • 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;