共用方式為


SET TIME ZONE

適用於:核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime

設定目前會話的時區。

語法

SET TIME ZONE { LOCAL | time_zone_value | interval_literal }

Parameters

  • LOCAL

    適用於:核取記號為「是」 Databricks Runtime

    Set 時區設為 java user.timezone 屬性中指定的時區,如果 user.timezone 未定義,則使用 TZ 環境變數,如果兩者皆未定義,則使用系統時區。

    適用於:核取記號為「是」 Databricks SQL

    重設 timezoneSET 命令 TIMEZONE 參數中的值 set。

    系統預設為 UTC

  • timezone_value

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

    如需有效時區的 list,請參閱 tz 資料庫時區的 List

  • interval 常值

    間隔常值代表會話時區與 『UTC』 之間的差異。 它必須介於 [-18, 18] 小時和最大值到第二個精確度的範圍內,例如: 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 '08:30:00' HOUR TO SECOND;