通过

SET TIME ZONE

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

设置当前会话的时区。

语法

SET TIME ZONE { LOCAL | time_zone_value | interval_literal }

参数

  • 当地

    适用于：勾选“是” Databricks Runtime

    将时区设置为 java user.timezone 属性中指定的时区;如果未TZ定义，则设置为环境变量user.timezone;如果未定义这两个时区，则设置为系统时区。

    适用于：勾选“是” 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;