共用方式為

設定時區

  • 發行項

適用於： 檢查標示為是 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;