From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Tue, 8 May 2007 17:02:59 +0000 (+0000)
Subject: Add an explicit comment about POSIX time zone names having the reverse
X-Git-Tag: REL8_3_BETA1~708
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=97f796942fe529ed080a6b1695ec00fa19dfb191;p=postgresql

Add an explicit comment about POSIX time zone names having the reverse
sign convention from everyplace else in Postgres.  I don't suppose that
this will stop people from being confused, but at least we can say that
it's documented.
---

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 507b4b6142..e1fb7d4249 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.199 2007/05/03 15:05:56 neilc Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.200 2007/05/08 17:02:59 tgl Exp $ -->
 
  <chapter id="datatype">
   <title id="datatype-title">Data Types</title>
@@ -2275,6 +2275,11 @@ January 8 04:05:06 1999 PST
      reasonableness of the zone abbreviations.  For example, <literal>SET
      TIMEZONE TO FOOBAR0</> will work, leaving the system effectively using
      a rather peculiar abbreviation for UTC.
+     Another issue to keep in mind is that in POSIX time zone names,
+     positive offsets are used for locations <emphasis>west</> of Greenwich.
+     Everywhere else, <productname>PostgreSQL</productname> follows the
+     ISO-8601 convention that positive timezone offsets are <emphasis>east</>
+     of Greenwich.
     </para>
 
     <para>