Freigeben über


SET TIME ZONE

Gilt für: durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Legt die Zeitzone der aktuellen Sitzung fest.

Syntax

SET TIME ZONE { LOCAL | time_zone_value | interval_literal }

Parameter

  • LOCAL

    Gilt für: Häkchen Databricks Runtime

    Legt die Zeitzone auf die in der Java-Eigenschaft user.timezone angegebene Zeitzone oder auf die Umgebungsvariable TZ fest, wenn user.timezone nicht definiert ist. Verwendet die Systemzeitzone, wenn beide nicht definiert sind.

    Gilt für: Häkchen Databricks SQL

    Setzt die Zeitzone im Wertsatz im Parameter TIMEZONE des SET-Befehls zurück.

    Der Systemstandard lautet UTC.

  • timezone_value

    Ein STRING-Literal. Die ID der lokalen Zeitzone der Sitzung im Format von regionsbasierten Zonen-IDs oder Zonenoffsets. Die Regions-IDs müssen das Format „Bereich/Stadt“ aufweisen (z. B. „America/Los_Angeles“). Zonenoffsets müssen das Format „(+|-)HH“, „(+|-)HH:mm“ oder „(+|-)HH:mm:ss“ aufweisen (z. B. „-08“, „+01:00“ oder „-13:33:33“). Außerdem werden „UTC“ und „Z“ als Aliase von „+00:00“ unterstützt. Andere Kurznamen werden nicht empfohlen, da sie mehrdeutig sein können.

    Eine Liste der gültigen Zeitzonen finden Sie unter Liste der tz-Datenbankzeitzonen.

  • Intervallliteral

    Das Intervallliteral stellt den Unterschied zwischen der Sitzungszeitzone und „UTC“ dar. Es muss im Bereich von [-18, 18] Stunden liegen und höchstens Sekundengenauigkeit aufweisen, z. B. INTERVAL '15:40:32' HOUR TO SECOND.

Beispiele

-- 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;