diff --git a/docs/src/main/sphinx/language/types.rst b/docs/src/main/sphinx/language/types.rst index d2341e1d3e71..57111855a9a9 100644 --- a/docs/src/main/sphinx/language/types.rst +++ b/docs/src/main/sphinx/language/types.rst @@ -262,11 +262,27 @@ The following examples illustrate the behavior:: Instant in time that includes the date and time of day with ``P`` digits of precision for the fraction of seconds and with a time zone. Values of this type are rendered using the time zone from the value. -Time zones are expressed as the numeric UTC offset value:: +Time zones can be expressed in the following ways: + +* ``UTC``, with ``GMT``, ``Z``, or ``UT`` usable as aliases for UTC. +* ``+hh:mm`` or ``-hh:mm`` with ``hh:mm`` as an hour and minute offset from UTC. + Can be written with or without ``UTC``, ``GMT``, or ``UT`` as an alias for + UTC. +* An `IANA time zone name `_. + +The following examples demonstrate some of these syntax options:: + + SELECT TIMESTAMP '2001-08-22 03:04:05.321 UTC'; + -- 2001-08-22 03:04:05.321 UTC + + SELECT TIMESTAMP '2001-08-22 03:04:05.321 -08:30'; + -- 2001-08-22 03:04:05.321 -08:30 - TIMESTAMP '2001-08-22 03:04:05.321 -08:00'; - -- 2001-08-22 03:04:05.321-08:00 + SELECT TIMESTAMP '2001-08-22 03:04:05.321 GMT-08:30'; + -- 2001-08-22 03:04:05.321 -08:30 + SELECT TIMESTAMP '2001-08-22 03:04:05.321 America/New_York'; + -- 2001-08-22 03:04:05.321 America/New_York ``INTERVAL YEAR TO MONTH`` ^^^^^^^^^^^^^^^^^^^^^^^^^^