mirror/postgresql
2
0
Fork 0
mirror of https://git.postgresql.org/git/postgresql.git synced 2025-01-12 18:34:36 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix documentation to specify the correct range of timezone offsets for

Browse Source 
type time with time zone, ie, +/- 13:59 not +/- 12:00.  Also some minor
wording improvements.
This commit is contained in:
Tom Lane 2005-10-22 19:33:57 +00:00
parent 4d20df3c78
commit 96b85f1ccb
1 changed files with 15 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/src/sgml/datatype.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.162 2005/10/15 01:47:11 neilc Exp $ $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.163 2005/10/22 19:33:57 tgl Exp $
--> -->
<chapter id="datatype"> <chapter id="datatype">
@ -1367,7 +1367,7 @@ SELECT b, char_length(b) FROM test2;
<entry><type>time [ (<replaceable>p</replaceable>) ] [ without time zone ]</type></entry> <entry><type>time [ (<replaceable>p</replaceable>) ] [ without time zone ]</type></entry>
<entry>8 bytes</entry> <entry>8 bytes</entry>
<entry>times of day only</entry> <entry>times of day only</entry>
<entry>00:00:00.00</entry> <entry>00:00:00</entry>
<entry>24:00:00</entry> <entry>24:00:00</entry>
<entry>1 microsecond / 14 digits</entry> <entry>1 microsecond / 14 digits</entry>
</row> </row>
@ -1375,8 +1375,8 @@ SELECT b, char_length(b) FROM test2;
<entry><type>time [ (<replaceable>p</replaceable>) ] with time zone</type></entry> <entry><type>time [ (<replaceable>p</replaceable>) ] with time zone</type></entry>
<entry>12 bytes</entry> <entry>12 bytes</entry>
<entry>times of day only, with time zone</entry> <entry>times of day only, with time zone</entry>
<entry>00:00:00.00+12</entry> <entry>00:00:00+1359</entry>
<entry>24:00:00-12</entry> <entry>24:00:00-1359</entry>
<entry>1 microsecond / 14 digits</entry> <entry>1 microsecond / 14 digits</entry>
</row> </row>
</tbody> </tbody>
@ -1759,19 +1759,22 @@ January 8 04:05:06 1999 PST
<para> <para>
The <acronym>SQL</acronym> standard differentiates <type>timestamp without time zone</type> The <acronym>SQL</acronym> standard differentiates <type>timestamp without time zone</type>
and <type>timestamp with time zone</type> literals by the existence of a and <type>timestamp with time zone</type> literals by the presence of a
<quote>+</quote>; or <quote>-</quote>. Hence, according to the standard, <quote>+</quote> or <quote>-</quote>. Hence, according to the standard,
<programlisting>TIMESTAMP '2004-10-19 10:23:54'</programlisting> <programlisting>TIMESTAMP '2004-10-19 10:23:54'</programlisting>
is a <type>timestamp without time zone</type>, while is a <type>timestamp without time zone</type>, while
<programlisting>TIMESTAMP '2004-10-19 10:23:54+02'</programlisting> <programlisting>TIMESTAMP '2004-10-19 10:23:54+02'</programlisting>
is a <type>timestamp with time zone</type>. is a <type>timestamp with time zone</type>.
<productname>PostgreSQL</productname> <productname>PostgreSQL</productname> never examines the content of a
differs from the standard by requiring that <type>timestamp with time zone</type> literal string before determining its type, and therefore will treat
literals be explicitly typed: both of the above as <type>timestamp without time zone</type>. To
ensure that a literal is treated as <type>timestamp with time
zone</type>, give it the correct explicit type:
<programlisting>TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'</programlisting> <programlisting>TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'</programlisting>
If a literal is not explicitly indicated as being of <type>timestamp with time zone</type>, In a literal that has been decided to be <type>timestamp without time
<productname>PostgreSQL</productname> will silently ignore any time zone indication in the literal. zone</type>, <productname>PostgreSQL</productname> will silently ignore
That is, the resulting date/time value is derived from the date/time any time zone indication.
That is, the resulting value is derived from the date/time
fields in the input value, and is not adjusted for time zone. fields in the input value, and is not adjusted for time zone.
</para> </para>