分享方式:


設定時區

適用於: 檢查標示為是 Databricks SQL 檢查標示為是 Databricks Runtime

設定目前會話的時區。

語法

SET TIME ZONE { LOCAL | time_zone_value | interval_literal }

參數

  • LOCAL

    適用於: 檢查標示為是 Databricks Runtime

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

    適用於: 檢查標示為是 Databricks SQL

    重設命令之 TIMEZONE 參數SET中所設定值的時區。

    系統預設為 UTC

  • timezone_value

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

    如需有效時區的清單,請參閱 tz 資料庫時區清單。

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