SET TIME ZONE
适用于: Databricks SQL Databricks Runtime
设置当前会话的时区。
语法
SET TIME ZONE { LOCAL | time_zone_value | interval_literal }
参数
LOCAL
适用于: Databricks Runtime
将时区设置为 java
user.timezone
属性中指定的时区,如果user.timezone
未定义,则将时区设置为环境变量TZ
,如果两个时区都未定义,则设置为系统时区。适用于: Databricks SQL
将时区重置为
SET
命令的 TIMEZONE 参数中设置的值。系统默认值为
UTC
。timezone_value
STRING
文本。 会话本地时区的 ID,其格式为基于区域的区域 ID 或区域偏移。 区域 ID 必须具有“区域/城市”的格式,如“America/Los_Angeles”。 区域偏移的格式必须是“(+|-)HH
”、“(+|-)HH:mm
”或“(+|-)HH:mm:ss
”,如“-08”、“+01:00”或“-13:33:33”。 此外,还支持“UTC”和“Z”作为“+00:00”的别名。 不建议使用其他短名称,因为它们可能不明确。-
间隔字面量表示会话时区与“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;