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”的别名。 不建议使用其他短名称,因为它们可能不明确。

    有关有效时区的列表,请参阅 tz 数据库时区的列表

  • 间隔字面量

    间隔字面量表示会话时区与“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;