通过

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;