doc: mention that SET TIME ZONE often needs to be quoted

Also mention that time zone abbreviations are not supported.

Reported-by: philippe.godfrin@nov.com

Discussion: https://postgr.es/m/163888728952.1269.5167822676466793158@wrigleys.postgresql.org

Backpatch-through: 10
This commit is contained in:
Bruce Momjian 2022-08-31 20:27:27 -04:00
parent 62c49fca13
commit a009cb3141
1 changed files with 5 additions and 4 deletions

View File

@ -22,7 +22,7 @@ PostgreSQL documentation
<refsynopsisdiv>
<synopsis>
SET [ SESSION | LOCAL ] <replaceable class="parameter">configuration_parameter</replaceable> { TO | = } { <replaceable class="parameter">value</replaceable> | '<replaceable class="parameter">value</replaceable>' | DEFAULT }
SET [ SESSION | LOCAL ] TIME ZONE { <replaceable class="parameter">timezone</replaceable> | LOCAL | DEFAULT }
SET [ SESSION | LOCAL ] TIME ZONE { <replaceable class="parameter">value</replaceable> | '<replaceable class="parameter">value</replaceable>' | LOCAL | DEFAULT }
</synopsis>
</refsynopsisdiv>
@ -192,8 +192,8 @@ SELECT setseed(<replaceable>value</replaceable>);
<varlistentry>
<term><literal>TIME ZONE</literal></term>
<listitem>
<para><literal>SET TIME ZONE <replaceable>value</replaceable></literal> is an alias
for <literal>SET timezone TO <replaceable>value</replaceable></literal>. The
<para><literal>SET TIME ZONE '<replaceable>value</replaceable>'</literal> is an alias
for <literal>SET timezone TO '<replaceable>value</replaceable>'</literal>. The
syntax <literal>SET TIME ZONE</literal> allows special syntax
for the time zone specification. Here are examples of valid
values:
@ -254,7 +254,8 @@ SELECT setseed(<replaceable>value</replaceable>);
</para>
<para>
See <xref linkend="datatype-timezones"/> for more information
Time zone abbreviations are not supported by <command>SET</command>;
see <xref linkend="datatype-timezones"/> for more information
about time zones.
</para>
</listitem>