SET TIME ZONE
Applies to: Databricks SQL
Databricks Runtime
Sets the time zone of the current session.
Syntax
SET TIME ZONE { LOCAL | time_zone_value | interval_literal }
Parameters
LOCAL
Applies to:
Databricks Runtime
Set the time zone to the one specified in the java
user.timezone
property, or to the environment variableTZ
ifuser.timezone
is undefined, or to the system time zone if both of them are undefined.Applies to:
Databricks SQL
Resets the timezone the value set in the TIMEZONE parameter of the
SET
command.The system default it
UTC
.timezone_value
A
STRING
literal. The ID of session local timezone in the format of either region-based zone IDs or zone offsets. Region IDs must have the form ‘area/city’, such as ‘America/Los_Angeles’. Zone offsets must be in the format ‘(+|-)HH
’, ‘(+|-)HH:mm
’ or ‘(+|-)HH:mm:ss
’, e.g ‘-08’, ‘+01:00’ or ‘-13:33:33’. Also, ‘UTC’ and ‘Z’ are supported as aliases of ‘+00:00’. Other short names are not recommended to use because they can be ambiguous.For a list of valid timezones, see List of tz database time zones.
-
The interval literal represents the difference between the session time zone to the ‘UTC’. It must be in the range of [-18, 18] hours and max to second precision, for example:
INTERVAL '15:40:32' HOUR TO SECOND
.
Examples
-- 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;
Related articles
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for