projects / postgresql.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 9adb2c4)
Update timezone documentation to reflect current reality: instead of
authorTom Lane
Fri, 22 Sep 2006 16:20:00 +0000 (16:20 +0000)
committerTom Lane
Fri, 22 Sep 2006 16:20:00 +0000 (16:20 +0000)
giving tables of known timezone names, refer the user to the system views.
Joachim Wieland

doc/src/sgml/datatype.sgml patch | blob | blame | history
doc/src/sgml/datetime.sgml patch | blob | blame | history
doc/src/sgml/func.sgml patch | blob | blame | history
doc/src/sgml/ref/set.sgml patch | blob | blame | history

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 5bca7c418f3ea91b849d22542ff0775bda9d9ff8..d9e4ea11b378fd4d5951edfce9f0a69963b45263 100644 (file)
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1,4 +1,4 @@
-
+
 
  
   Data Types
@@ -1706,8 +1706,8 @@ SELECT b, char_length(b) FROM test2;
       
 
      
-     Refer to etime-appendix"> for a list of
-     time zone names that are recognized for input.
+     Refer to atype-timezones"> for more information on how
+     to specify time zones.
     
     
 
@@ -2151,6 +2151,83 @@ January 8 04:05:06 1999 PST
      parameter before being displayed to the client.
     
 
+    
+     PostgreSQL allows you to specify time zones in
+     three different forms:
+     
+      
+       
+        A full time zone name, for example America/New_York.
+        The recognized time zone names are listed in the
+        pg_timezone_names view (see 
+        linkend="view-pg-timezone-names">).
+        PostgreSQL uses the widely-used
+        zic time zone data for this purpose, so the same
+        names are also recognized by much other software.
+       
+      
+      
+       
+        A time zone abbreviation, for example PST.  Such a
+        specification merely defines a particular offset from UTC, in
+        contrast to full time zone names which may imply a set of daylight
+        savings transition-date rules as well.  The recognized abbreviations
+        are listed in the pg_timezone_abbrevs view (see 
+        linkend="view-pg-timezone-abbrevs">).  You cannot set the
+        configuration parameter  using a time
+        zone abbreviation, but you can use abbreviations in
+        date/time input values and with the AT TIME ZONE
+        operator.
+       
+      
+      
+       
+        In addition to the timezone names and abbreviations,
+        PostgreSQL will accept time zone
+        specifications of the form STDoffset or
+        STDoffsetDST, where
+        STD is a zone abbreviation, offset is a
+        numeric offset in hours west from UTC, and DST is an
+        optional daylight-savings zone abbreviation, assumed to stand for one
+        hour ahead of the given offset. For example, if EST5EDT
+        were not already a recognized zone name, it would be accepted and would
+        be functionally equivalent to USA East Coast time.  When a
+        daylight-savings zone name is present, it is assumed to be used
+        according to USA time zone rules, so this feature is of limited use
+        outside North America.  One should also be wary that this provision can
+        lead to silently accepting bogus input, since there is no check on the
+        reasonableness of the zone abbreviations.  For example, SET
+        TIMEZONE TO FOOBAR0 will work, leaving the system effectively using
+        a rather peculiar abbreviation for GMT.
+       
+      
+     
+
+     There is a conceptual and practical difference between the abbreviations
+     and the full names: abbreviations always represent a fixed offset from
+     UTC, whereas most of the full names imply a local daylight-savings time
+     rule and so have two possible UTC offsets. That's why you always have to
+     specify a date if you want to use full time zone names in timetz
+     values. This is also the reason why you should set 
+     linkend="guc-timezone"> to a full time zone name: this way,
+     PostgreSQL
+     will always know the correct UTC offset for your region.
+    
+
+    
+     Note that timezone names are not used for date/time output
+     — all supported output formats use numeric timezone displays to
+     avoid ambiguity.
+    
+
+    
+     Neither full names nor abbreviations are hard-wired into the server;
+     they are obtained from configuration files stored under
+     .../share/timezone/ and .../share/timezonesets/
+     of the installation directory
+     (see ).
+    
+
     
      The  configuration parameter can
      be set in the file postgresql.conf, or in any of the
@@ -2191,12 +2268,6 @@ January 8 04:05:06 1999 PST
       
      
     
-
-   
-    Refer to  for a list of
-    available time zones.
-   
-
    
 
    
@@ -3424,10 +3495,9 @@ SELECT * FROM pg_attribute
     
 
      
-   Missing features include XQuery, SQL/XML syntax (ISO/IEC
-   9075-14), and an XML data type optimized for
-   XML storage.
-   
+      Missing features include XQuery, SQL/XML syntax (ISO/IEC
+      9075-14), and an XML data type optimized for
+      XML storage.
      
     
    
diff --git a/doc/src/sgml/datetime.sgml b/doc/src/sgml/datetime.sgml
index f9d65b16f37ec152ec4af218afd0eabd998300b2..09e7d1797ac5a316cea515bd8511390218d3913f 100644 (file)
--- a/doc/src/sgml/datetime.sgml
+++ b/doc/src/sgml/datetime.sgml
@@ -1,4 +1,4 @@
-
+
 
  
   Date/Time Support
@@ -359,1848 +359,6 @@
     time zone
     input abbreviations
    
-
-   
-     shows the time zone
-    abbreviations recognized by PostgreSQL
-    in date/time input values.  These abbreviations are not
-    hard-wired into the server, but are obtained from a configuration
-    file (see ).  Note that these
-    names are not used for date/time output — all supported
-    output formats use numeric timezone displays to avoid ambiguity.
-   
-
-   
-    In addition to these abbreviations, the full timezone names shown in
-     can be used
-    in date/time input values.  There is a conceptual and
-    practical difference between the abbreviations and the full names:
-    abbreviations always represent a fixed offset from UTC, whereas most
-    of the full names imply a local daylight-savings time rule and so
-    have two possible UTC offsets. That's why
-    you always have to specify a date if you want to use full time zone
-    names in timetz values.
-   
-
-   
-    The table is organized by time zone offset from UTC,
-    rather than alphabetically.  This is intended to facilitate
-    matching local usage with recognized abbreviations for cases where
-    these might differ.
-   
-
-    
-     Time Zone Abbreviations for Input
-     
-      
-       
-        Time Zone
-        Offset from UTC
-        Description
-       
-      
-      
-       
-        NZDT
-        +13:00
-        New Zealand Daylight-Saving Time
-       
-       
-        IDLE
-        +12:00
-        International Date Line, East
-       
-       
-        NZST
-        +12:00
-        New Zealand Standard Time
-       
-       
-        NZT
-        +12:00
-        New Zealand Time
-       
-       
-        AESST
-        +11:00
-        Australia Eastern Summer Standard Time
-       
-       
-        ACSST
-        +10:30
-        Central Australia Summer Standard Time
-       
-       
-        CADT
-        +10:30
-        Central Australia Daylight-Saving Time
-       
-       
-        SADT
-        +10:30
-        South Australian Daylight-Saving Time
-       
-       
-        AEST
-        +10:00
-        Australia Eastern Standard Time
-       
-       
-        EAST
-        +10:00
-        East Australian Standard Time
-       
-       
-        GST
-        +10:00
-        Guam Standard Time, Russia zone 9
-       
-       
-        LIGT
-        +10:00
-        Melbourne, Australia
-       
-       
-        SAST
-        +09:30
-        South Australia Standard Time
-       
-       
-        CAST
-        +09:30
-        Central Australia Standard Time
-       
-       
-        AWSST
-        +09:00
-        Australia Western Summer Standard Time
-       
-       
-        JST
-        +09:00
-        Japan Standard Time, Russia zone 8
-       
-       
-        KST
-        +09:00
-        Korea Standard Time
-       
-       
-        MHT
-        +09:00
-        Kwajalein Time
-       
-       
-        WDT
-        +09:00
-        West Australian Daylight-Saving Time
-       
-       
-        MT
-        +08:30
-        Moluccas Time
-       
-       
-        AWST
-        +08:00
-        Australia Western Standard Time
-       
-       
-        CCT
-        +08:00
-        China Coastal Time
-       
-       
-        WADT
-        +08:00
-        West Australian Daylight-Saving Time
-       
-       
-        WST
-        +08:00
-        West Australian Standard Time
-       
-       
-        JT
-        +07:30
-        Java Time
-       
-       
-        ALMST
-        +07:00
-        Almaty Summer Time
-       
-       
-        WAST
-        +07:00
-        West Australian Standard Time
-       
-       
-        CXT
-        +07:00
-        Christmas (Island) Time
-       
-       
-        MMT
-        +06:30
-        Myanmar Time
-       
-       
-        ALMT
-        +06:00
-        Almaty Time
-       
-       
-        MAWT
-        +06:00
-        Mawson (Antarctica) Time
-       
-       
-        IOT
-        +05:00
-        Indian Chagos Time
-       
-       
-        MVT
-        +05:00
-        Maldives Island Time
-       
-       
-        TFT
-        +05:00
-        Kerguelen Time
-       
-       
-        AFT
-        +04:30
-        Afghanistan Time
-       
-       
-        EAST
-        +04:00
-        Antananarivo Summer Time
-       
-       
-        MUT
-        +04:00
-        Mauritius Island Time
-       
-       
-        RET
-        +04:00
-        Reunion Island Time
-       
-       
-        SCT
-        +04:00
-        Mahe Island Time
-       
-       
-        IRT, IT
-        +03:30
-        Iran Time
-       
-       
-        EAT
-        +03:00
-        Antananarivo, Comoro Time
-       
-       
-        BT
-        +03:00
-        Baghdad Time
-       
-       
-        EETDST
-        +03:00
-        Eastern Europe Daylight-Saving Time
-       
-       
-        HMT
-        +03:00
-        Hellas Mediterranean Time (?)
-       
-       
-        BDST
-        +02:00
-        British Double Summer Time
-       
-       
-        CEST
-        +02:00
-        Central European Summer Time
-       
-       
-        CETDST
-        +02:00
-        Central European Daylight-Saving Time
-       
-       
-        EET
-        +02:00
-        Eastern European Time, Russia zone 1
-       
-       
-        FWT
-        +02:00
-        French Winter Time
-       
-       
-        IST
-        +02:00
-        Israel Standard Time
-       
-       
-        MEST
-        +02:00
-        Middle European Summer Time
-       
-       
-        METDST
-        +02:00
-        Middle Europe Daylight-Saving Time
-       
-       
-        SST
-        +02:00
-        Swedish Summer Time
-       
-       
-        BST
-        +01:00
-        British Summer Time
-       
-       
-        CET
-        +01:00
-        Central European Time
-       
-       
-        DNT
-        +01:00
-        Dansk Normal Tid
-       
-       
-        FST
-        +01:00
-        French Summer Time
-       
-       
-        MET
-        +01:00
-        Middle European Time
-       
-       
-        MEWT
-        +01:00
-        Middle European Winter Time
-       
-       
-        MEZ
-        +01:00
-        Mitteleuropäische Zeit
-       
-       
-        NOR
-        +01:00
-        Norway Standard Time
-       
-       
-        SET
-        +01:00
-        Seychelles Time
-       
-       
-        SWT
-        +01:00
-        Swedish Winter Time
-       
-       
-        WETDST
-        +01:00
-        Western European Daylight-Saving Time
-       
-       
-        GMT
-        00:00
-        Greenwich Mean Time
-       
-       
-        UT
-        00:00
-        Universal Time
-       
-       
-        UTC
-        00:00
-        Universal Coordinated Time
-       
-       
-        Z
-        00:00
-        Same as UTC
-       
-       
-        ZULU
-        00:00
-        Same as UTC
-       
-       
-        WET
-        00:00
-        Western European Time
-       
-       
-        WAT
-        -01:00
-        West Africa Time
-       
-       
-        FNST
-        -01:00
-        Fernando de Noronha Summer Time
-       
-       
-        FNT
-        -02:00
-        Fernando de Noronha Time
-       
-       
-        BRST
-        -02:00
-        Brasilia Summer Time
-       
-       
-        NDT
-        -02:30
-        Newfoundland Daylight-Saving Time
-       
-       
-        ADT
-        -03:00
-        Atlantic Daylight-Saving Time
-       
-       
-        AWT
-        -03:00
-        (unknown)
-       
-       
-        BRT
-        -03:00
-        Brasilia Time
-       
-       
-        NFT
-        -03:30
-        Newfoundland Standard Time
-       
-       
-        NST
-        -03:30
-        Newfoundland Standard Time
-       
-       
-        AST
-        -04:00
-        Atlantic Standard Time (Canada)
-       
-       
-        ACST
-        -04:00
-        Atlantic/Porto Acre Summer Time
-       
-       
-        EDT
-        -04:00
-        Eastern Daylight-Saving Time
-       
-       
-       
-        ACT
-        -05:00
-        Atlantic/Porto Acre Standard Time
-       
-       
-        CDT
-        -05:00
-        Central Daylight-Saving Time
-       
-       
-        EST
-        -05:00
-        Eastern Standard Time
-       
-       
-       
-        CST
-        -06:00
-        Central Standard Time
-       
-       
-        MDT
-        -06:00
-        Mountain Daylight-Saving Time
-       
-       
-       
-        MST
-        -07:00
-        Mountain Standard Time
-       
-       
-        PDT
-        -07:00
-        Pacific Daylight-Saving Time
-       
-       
-        AKDT
-        -08:00
-        Alaska Daylight-Saving Time
-       
-       
-        PST
-        -08:00
-        Pacific Standard Time
-       
-       
-        YDT
-        -08:00
-        Yukon Daylight-Saving Time
-       
-       
-        AKST
-        -09:00
-        Alaska Standard Time
-       
-       
-        HDT
-        -09:00
-        Hawaii/Alaska Daylight-Saving Time
-       
-       
-        YST
-        -09:00
-        Yukon Standard Time
-       
-       
-        MART
-        -09:30
-        Marquesas Time
-       
-       
-        AHST
-        -10:00
-        Alaska/Hawaii Standard Time
-       
-       
-        HST
-        -10:00
-        Hawaii Standard Time
-       
-       
-        CAT
-        -10:00
-        Central Alaska Time
-       
-       
-        NT
-        -11:00
-        Nome Time
-       
-       
-        IDLW
-        -12:00
-        International Date Line, West
-       
-      
-     
-    
-
-   
-    time zone
-    configuration names
-   
-
-   
-     shows the time zone
-    names recognized by PostgreSQL as valid
-    settings for the  parameter.  These names
-    are not hard-wired into the server, but are in fact names of configuration
-    files stored under .../share/timezone/ of the installation
-    directory.
-   
-
-   
-    In many cases there are several equivalent names for the same zone.
-    These are listed on the same line.  The table is primarily sorted
-    by the name of the principal city of the zone.
-   
-
-    
-     Time Zone Names for setting <varname>timezone</>
-     
-      
-       
-        Time Zone
-       
-      
-
- 
-  Africa/Abidjan
- 
- 
-  Africa/Accra
- 
- 
-  Africa/Addis_Ababa
- 
- 
-  Africa/Algiers
- 
- 
-  Africa/Asmera
- 
- 
-  Africa/Bamako
- 
- 
-  Africa/Bangui
- 
- 
-  Africa/Banjul
- 
- 
-  Africa/Bissau
- 
- 
-  Africa/Blantyre
- 
- 
-  Africa/Brazzaville
- 
- 
-  Africa/Bujumbura
- 
- 
-  Africa/Cairo Egypt
- 
- 
-  Africa/Casablanca
- 
- 
-  Africa/Ceuta
- 
- 
-  Africa/Conakry
- 
- 
-  Africa/Dakar
- 
- 
-  Africa/Dar_es_Salaam
- 
- 
-  Africa/Djibouti
- 
- 
-  Africa/Douala
- 
- 
-  Africa/El_Aaiun
- 
- 
-  Africa/Freetown
- 
- 
-  Africa/Gaborone
- 
- 
-  Africa/Harare
- 
- 
-  Africa/Johannesburg
- 
- 
-  Africa/Kampala
- 
- 
-  Africa/Khartoum
- 
- 
-  Africa/Kigali
- 
- 
-  Africa/Kinshasa
- 
- 
-  Africa/Lagos
- 
- 
-  Africa/Libreville
- 
- 
-  Africa/Lome
- 
- 
-  Africa/Luanda
- 
- 
-  Africa/Lubumbashi
- 
- 
-  Africa/Lusaka
- 
- 
-  Africa/Malabo
- 
- 
-  Africa/Maputo
- 
- 
-  Africa/Maseru
- 
- 
-  Africa/Mbabane
- 
- 
-  Africa/Mogadishu
- 
- 
-  Africa/Monrovia
- 
- 
-  Africa/Nairobi
- 
- 
-  Africa/Ndjamena
- 
- 
-  Africa/Niamey
- 
- 
-  Africa/Nouakchott
- 
- 
-  Africa/Ouagadougou
- 
- 
-  Africa/Porto-Novo
- 
- 
-  Africa/Sao_Tome
- 
- 
-  Africa/Timbuktu
- 
- 
-  Africa/Tripoli Libya
- 
- 
-  Africa/Tunis
- 
- 
-  Africa/Windhoek
- 
- 
-  America/Adak America/Atka US/Aleutian
- 
- 
-  America/Anchorage SystemV/YST9YDT US/Alaska
- 
- 
-  America/Anguilla
- 
- 
-  America/Antigua
- 
- 
-  America/Araguaina
- 
- 
-  America/Aruba
- 
- 
-  America/Asuncion
- 
- 
-  America/Bahia
- 
- 
-  America/Barbados
- 
- 
-  America/Belem
- 
- 
-  America/Belize
- 
- 
-  America/Boa_Vista
- 
- 
-  America/Bogota
- 
- 
-  America/Boise
- 
- 
-  America/Buenos_Aires
- 
- 
-  America/Cambridge_Bay
- 
- 
-  America/Campo_Grande
- 
- 
-  America/Cancun
- 
- 
-  America/Caracas
- 
- 
-  America/Catamarca
- 
- 
-  America/Cayenne
- 
- 
-  America/Cayman
- 
- 
-  America/Chicago CST6CDT SystemV/CST6CDT US/Central
- 
- 
-  America/Chihuahua
- 
- 
-  America/Cordoba America/Rosario
- 
- 
-  America/Costa_Rica
- 
- 
-  America/Cuiaba
- 
- 
-  America/Curacao
- 
- 
-  America/Danmarkshavn
- 
- 
-  America/Dawson
- 
- 
-  America/Dawson_Creek
- 
- 
-  America/Denver MST7MDT SystemV/MST7MDT US/Mountain America/Shiprock Navajo
- 
- 
-  America/Detroit US/Michigan
- 
- 
-  America/Dominica
- 
- 
-  America/Edmonton Canada/Mountain
- 
- 
-  America/Eirunepe
- 
- 
-  America/El_Salvador
- 
- 
-  America/Ensenada America/Tijuana Mexico/BajaNorte
- 
- 
-  America/Fortaleza
- 
- 
-  America/Glace_Bay
- 
- 
-  America/Godthab
- 
- 
-  America/Goose_Bay
- 
- 
-  America/Grand_Turk
- 
- 
-  America/Grenada
- 
- 
-  America/Guadeloupe
- 
- 
-  America/Guatemala
- 
- 
-  America/Guayaquil
- 
- 
-  America/Guyana
- 
- 
-  America/Halifax Canada/Atlantic SystemV/AST4ADT
- 
- 
-  America/Havana Cuba
- 
- 
-  America/Hermosillo
- 
- 
-  America/Indiana/Indianapolis America/Indianapolis America/Fort_Wayne EST SystemV/EST5 US/East-Indiana
- 
- 
-  America/Indiana/Knox America/Knox_IN US/Indiana-Starke
- 
- 
-  America/Indiana/Marengo
- 
- 
-  America/Indiana/Vevay
- 
- 
-  America/Inuvik
- 
- 
-  America/Iqaluit
- 
- 
-  America/Jamaica Jamaica
- 
- 
-  America/Jujuy
- 
- 
-  America/Juneau
- 
- 
-  America/Kentucky/Louisville America/Louisville
- 
- 
-  America/Kentucky/Monticello
- 
- 
-  America/La_Paz
- 
- 
-  America/Lima
- 
- 
-  America/Los_Angeles PST8PDT SystemV/PST8PDT US/Pacific US/Pacific-New
- 
- 
-  America/Maceio
- 
- 
-  America/Managua
- 
- 
-  America/Manaus Brazil/West
- 
- 
-  America/Martinique
- 
- 
-  America/Mazatlan Mexico/BajaSur
- 
- 
-  America/Mendoza
- 
- 
-  America/Menominee
- 
- 
-  America/Merida
- 
- 
-  America/Mexico_City Mexico/General
- 
- 
-  America/Miquelon
- 
- 
-  America/Monterrey
- 
- 
-  America/Montevideo
- 
- 
-  America/Montreal
- 
- 
-  America/Montserrat
- 
- 
-  America/Nassau
- 
- 
-  America/New_York EST5EDT SystemV/EST5EDT US/Eastern
- 
- 
-  America/Nipigon
- 
- 
-  America/Nome
- 
- 
-  America/Noronha Brazil/DeNoronha
- 
- 
-  America/North_Dakota/Center
- 
- 
-  America/Panama
- 
- 
-  America/Pangnirtung
- 
- 
-  America/Paramaribo
- 
- 
-  America/Phoenix MST SystemV/MST7 US/Arizona
- 
- 
-  America/Port-au-Prince
- 
- 
-  America/Port_of_Spain
- 
- 
-  America/Porto_Acre America/Rio_Branco Brazil/Acre
- 
- 
-  America/Porto_Velho
- 
- 
-  America/Puerto_Rico SystemV/AST4
- 
- 
-  America/Rainy_River
- 
- 
-  America/Rankin_Inlet
- 
- 
-  America/Recife
- 
- 
-  America/Regina Canada/East-Saskatchewan Canada/Saskatchewan SystemV/CST6
- 
- 
-  America/Santiago Chile/Continental
- 
- 
-  America/Santo_Domingo
- 
- 
-  America/Sao_Paulo Brazil/East
- 
- 
-  America/Scoresbysund
- 
- 
-  America/St_Johns Canada/Newfoundland
- 
- 
-  America/St_Kitts
- 
- 
-  America/St_Lucia
- 
- 
-  America/St_Thomas America/Virgin
- 
- 
-  America/St_Vincent
- 
- 
-  America/Swift_Current
- 
- 
-  America/Tegucigalpa
- 
- 
-  America/Thule
- 
- 
-  America/Thunder_Bay
- 
- 
-  America/Toronto Canada/Eastern
- 
- 
-  America/Tortola
- 
- 
-  America/Vancouver Canada/Pacific
- 
- 
-  America/Whitehorse Canada/Yukon
- 
- 
-  America/Winnipeg Canada/Central
- 
- 
-  America/Yakutat
- 
- 
-  America/Yellowknife
- 
- 
-  Antarctica/Casey
- 
- 
-  Antarctica/Davis
- 
- 
-  Antarctica/DumontDUrville
- 
- 
-  Antarctica/Mawson
- 
- 
-  Antarctica/McMurdo Antarctica/South_Pole
- 
- 
-  Antarctica/Palmer
- 
- 
-  Antarctica/Rothera
- 
- 
-  Antarctica/Syowa
- 
- 
-  Antarctica/Vostok
- 
- 
-  Asia/Aden
- 
- 
-  Asia/Almaty
- 
- 
-  Asia/Amman
- 
- 
-  Asia/Anadyr
- 
- 
-  Asia/Aqtau
- 
- 
-  Asia/Aqtobe
- 
- 
-  Asia/Ashgabat Asia/Ashkhabad
- 
- 
-  Asia/Baghdad
- 
- 
-  Asia/Bahrain
- 
- 
-  Asia/Baku
- 
- 
-  Asia/Bangkok
- 
- 
-  Asia/Beirut
- 
- 
-  Asia/Bishkek
- 
- 
-  Asia/Brunei
- 
- 
-  Asia/Calcutta
- 
- 
-  Asia/Choibalsan
- 
- 
-  Asia/Chongqing Asia/Chungking
- 
- 
-  Asia/Colombo
- 
- 
-  Asia/Dacca Asia/Dhaka
- 
- 
-  Asia/Damascus
- 
- 
-  Asia/Dili
- 
- 
-  Asia/Dubai
- 
- 
-  Asia/Dushanbe
- 
- 
-  Asia/Gaza
- 
- 
-  Asia/Harbin
- 
- 
-  Asia/Hong_Kong Hongkong
- 
- 
-  Asia/Hovd
- 
- 
-  Asia/Irkutsk
- 
- 
-  Asia/Jakarta
- 
- 
-  Asia/Jayapura
- 
- 
-  Asia/Jerusalem Asia/Tel_Aviv Israel
- 
- 
-  Asia/Kabul
- 
- 
-  Asia/Kamchatka
- 
- 
-  Asia/Karachi
- 
- 
-  Asia/Kashgar
- 
- 
-  Asia/Katmandu
- 
- 
-  Asia/Krasnoyarsk
- 
- 
-  Asia/Kuala_Lumpur
- 
- 
-  Asia/Kuching
- 
- 
-  Asia/Kuwait
- 
- 
-  Asia/Macao Asia/Macau
- 
- 
-  Asia/Magadan
- 
- 
-  Asia/Makassar Asia/Ujung_Pandang
- 
- 
-  Asia/Manila
- 
- 
-  Asia/Muscat
- 
- 
-  Asia/Nicosia Europe/Nicosia
- 
- 
-  Asia/Novosibirsk
- 
- 
-  Asia/Omsk
- 
- 
-  Asia/Oral
- 
- 
-  Asia/Phnom_Penh
- 
- 
-  Asia/Pontianak
- 
- 
-  Asia/Pyongyang
- 
- 
-  Asia/Qatar
- 
- 
-  Asia/Qyzylorda
- 
- 
-  Asia/Rangoon
- 
- 
-  Asia/Riyadh
- 
- 
-  Asia/Riyadh87 Mideast/Riyadh87
- 
- 
-  Asia/Riyadh88 Mideast/Riyadh88
- 
- 
-  Asia/Riyadh89 Mideast/Riyadh89
- 
- 
-  Asia/Saigon
- 
- 
-  Asia/Sakhalin
- 
- 
-  Asia/Samarkand
- 
- 
-  Asia/Seoul ROK
- 
- 
-  Asia/Shanghai PRC
- 
- 
-  Asia/Singapore Singapore
- 
- 
-  Asia/Taipei ROC
- 
- 
-  Asia/Tashkent
- 
- 
-  Asia/Tbilisi
- 
- 
-  Asia/Tehran Iran
- 
- 
-  Asia/Thimbu Asia/Thimphu
- 
- 
-  Asia/Tokyo Japan
- 
- 
-  Asia/Ulaanbaatar Asia/Ulan_Bator
- 
- 
-  Asia/Urumqi
- 
- 
-  Asia/Vientiane
- 
- 
-  Asia/Vladivostok
- 
- 
-  Asia/Yakutsk
- 
- 
-  Asia/Yekaterinburg
- 
- 
-  Asia/Yerevan
- 
- 
-  Atlantic/Azores
- 
- 
-  Atlantic/Bermuda
- 
- 
-  Atlantic/Canary
- 
- 
-  Atlantic/Cape_Verde
- 
- 
-  Atlantic/Faeroe
- 
- 
-  Atlantic/Madeira
- 
- 
-  Atlantic/Reykjavik Iceland
- 
- 
-  Atlantic/South_Georgia
- 
- 
-  Atlantic/St_Helena
- 
- 
-  Atlantic/Stanley
- 
- 
-  Australia/ACT Australia/Canberra Australia/NSW Australia/Sydney
- 
- 
-  Australia/Adelaide Australia/South
- 
- 
-  Australia/Brisbane Australia/Queensland
- 
- 
-  Australia/Broken_Hill Australia/Yancowinna
- 
- 
-  Australia/Darwin Australia/North
- 
- 
-  Australia/Hobart Australia/Tasmania
- 
- 
-  Australia/LHI Australia/Lord_Howe
- 
- 
-  Australia/Lindeman
- 
- 
-  Australia/Melbourne Australia/Victoria
- 
- 
-  Australia/Perth Australia/West
- 
- 
-  CET
- 
- 
-  EET
- 
- 
-  Etc/GMT+1
- 
- 
-  Etc/GMT+2
- 
- 
-  Etc/GMT+3
- 
- 
-  Etc/GMT+4
- 
- 
-  Etc/GMT+5
- 
- 
-  Etc/GMT+6
- 
- 
-  Etc/GMT+7
- 
- 
-  Etc/GMT+8
- 
- 
-  Etc/GMT+9
- 
- 
-  Etc/GMT+10
- 
- 
-  Etc/GMT+11
- 
- 
-  Etc/GMT+12
- 
- 
-  Etc/GMT-1
- 
- 
-  Etc/GMT-2
- 
- 
-  Etc/GMT-3
- 
- 
-  Etc/GMT-4
- 
- 
-  Etc/GMT-5
- 
- 
-  Etc/GMT-6
- 
- 
-  Etc/GMT-7
- 
- 
-  Etc/GMT-8
- 
- 
-  Etc/GMT-9
- 
- 
-  Etc/GMT-10
- 
- 
-  Etc/GMT-11
- 
- 
-  Etc/GMT-12
- 
- 
-  Etc/GMT-13
- 
- 
-  Etc/GMT-14
- 
- 
-  Europe/Amsterdam
- 
- 
-  Europe/Andorra
- 
- 
-  Europe/Athens
- 
- 
-  Europe/Belfast
- 
- 
-  Europe/Belgrade Europe/Ljubljana Europe/Sarajevo Europe/Skopje Europe/Zagreb
- 
- 
-  Europe/Berlin
- 
- 
-  Europe/Brussels
- 
- 
-  Europe/Bucharest
- 
- 
-  Europe/Budapest
- 
- 
-  Europe/Chisinau Europe/Tiraspol
- 
- 
-  Europe/Copenhagen
- 
- 
-  Europe/Dublin Eire
- 
- 
-  Europe/Gibraltar
- 
- 
-  Europe/Helsinki
- 
- 
-  Europe/Istanbul Asia/Istanbul Turkey
- 
- 
-  Europe/Kaliningrad
- 
- 
-  Europe/Kiev
- 
- 
-  Europe/Lisbon Portugal
- 
- 
-  Europe/London GB GB-Eire
- 
- 
-  Europe/Luxembourg
- 
- 
-  Europe/Madrid
- 
- 
-  Europe/Malta
- 
- 
-  Europe/Minsk
- 
- 
-  Europe/Monaco
- 
- 
-  Europe/Moscow W-SU
- 
- 
-  Europe/Oslo Arctic/Longyearbyen Atlantic/Jan_Mayen
- 
- 
-  Europe/Paris
- 
- 
-  Europe/Prague Europe/Bratislava
- 
- 
-  Europe/Riga
- 
- 
-  Europe/Rome Europe/San_Marino Europe/Vatican
- 
- 
-  Europe/Samara
- 
- 
-  Europe/Simferopol
- 
- 
-  Europe/Sofia
- 
- 
-  Europe/Stockholm
- 
- 
-  Europe/Tallinn
- 
- 
-  Europe/Tirane
- 
- 
-  Europe/Uzhgorod
- 
- 
-  Europe/Vaduz
- 
- 
-  Europe/Vienna
- 
- 
-  Europe/Vilnius
- 
- 
-  Europe/Warsaw Poland
- 
- 
-  Europe/Zaporozhye
- 
- 
-  Europe/Zurich
- 
- 
-  Factory
- 
- 
-  GMT GMT+0 GMT-0 GMT0 Greenwich Etc/GMT Etc/GMT+0 Etc/GMT-0 Etc/GMT0 Etc/Greenwich
- 
- 
-  Indian/Antananarivo
- 
- 
-  Indian/Chagos
- 
- 
-  Indian/Christmas
- 
- 
-  Indian/Cocos
- 
- 
-  Indian/Comoro
- 
- 
-  Indian/Kerguelen
- 
- 
-  Indian/Mahe
- 
- 
-  Indian/Maldives
- 
- 
-  Indian/Mauritius
- 
- 
-  Indian/Mayotte
- 
- 
-  Indian/Reunion
- 
- 
-  MET
- 
- 
-  Pacific/Apia
- 
- 
-  Pacific/Auckland NZ
- 
- 
-  Pacific/Chatham NZ-CHAT
- 
- 
-  Pacific/Easter Chile/EasterIsland
- 
- 
-  Pacific/Efate
- 
- 
-  Pacific/Enderbury
- 
- 
-  Pacific/Fakaofo
- 
- 
-  Pacific/Fiji
- 
- 
-  Pacific/Funafuti
- 
- 
-  Pacific/Galapagos
- 
- 
-  Pacific/Gambier SystemV/YST9
- 
- 
-  Pacific/Guadalcanal
- 
- 
-  Pacific/Guam
- 
- 
-  Pacific/Honolulu HST SystemV/HST10 US/Hawaii
- 
- 
-  Pacific/Johnston
- 
- 
-  Pacific/Kiritimati
- 
- 
-  Pacific/Kosrae
- 
- 
-  Pacific/Kwajalein Kwajalein
- 
- 
-  Pacific/Majuro
- 
- 
-  Pacific/Marquesas
- 
- 
-  Pacific/Midway
- 
- 
-  Pacific/Nauru
- 
- 
-  Pacific/Niue
- 
- 
-  Pacific/Norfolk
- 
- 
-  Pacific/Noumea
- 
- 
-  Pacific/Pago_Pago Pacific/Samoa US/Samoa
- 
- 
-  Pacific/Palau
- 
- 
-  Pacific/Pitcairn SystemV/PST8
- 
- 
-  Pacific/Ponape
- 
- 
-  Pacific/Port_Moresby
- 
- 
-  Pacific/Rarotonga
- 
- 
-  Pacific/Saipan
- 
- 
-  Pacific/Tahiti
- 
- 
-  Pacific/Tarawa
- 
- 
-  Pacific/Tongatapu
- 
- 
-  Pacific/Truk
- 
- 
-  Pacific/Wake
- 
- 
-  Pacific/Wallis
- 
- 
-  Pacific/Yap
- 
- 
-  UCT Etc/UCT
- 
- 
-  UTC Universal Zulu Etc/UTC Etc/Universal Etc/Zulu
- 
- 
-  WET
- 
-
-     
-    
-
-   
-    In addition to the names listed in the table,
-    PostgreSQL will accept
-     values of the
-    form STDoffset or
-    STDoffsetDST, where
-    STD is a zone abbreviation, offset is a
-    numeric offset in hours west from UTC, and DST is an
-    optional daylight-savings zone abbreviation, assumed to stand for one hour
-    ahead of the given offset.  For example, if EST5EDT were not
-    already a recognized zone name, it would be accepted and would be
-    functionally equivalent to USA East Coast time.  When a daylight-savings
-    zone name is present, it is assumed to be used according to USA time zone
-    rules, so this feature is of limited use outside North America.
-    One should also be wary that this provision can lead to
-    silently accepting bogus input, since there is no check on the
-    reasonableness of the zone abbreviations.  For example,
-    SET TIMEZONE TO FOOBAR0 will work, leaving the system
-    effectively using a rather peculiar abbreviation for GMT.
-   
-
   
 
   
@@ -2249,7 +407,8 @@
     negative being west.  For example, -18000 would be five hours west
     of Greenwich, or North American east coast standard time.  D
     indicates that the zone name represents local daylight-savings time
-    rather than standard time.
+    rather than standard time. Since all known time zone offsets are on
+    15 minute boundaries, the number of seconds has to be a multiple of 900.
    
 
    
@@ -2284,6 +443,14 @@
     the dot embedded in their names.
    
 
+   
+    
+     If an error occurs while reading the time zone data sets, no new value is
+     applied but the old set is kept. If the error occurs while starting the
+     database, startup fails.
+    
+   
+
    
     
      Time zone abbreviations defined in the configuration file override
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 3c956ad8eb3abde8335b155e0e62c1d679a7cacb..b3fe74fe502f22c3ddfb71ba24c9bdb0c954d1be 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,4 +1,4 @@
-
+
 
  
   Functions and Operators
@@ -6095,9 +6095,8 @@ SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40');
     In these expressions, the desired time zone zone can be
     specified either as a text string (e.g., 'PST')
     or as an interval (e.g., INTERVAL '-08:00').
-    In the text case, the available zone names are those shown in either
-     or
-    .
+    In the text case, a time zone name may be specified in any of the ways
+    described in .
    
 
    
diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml
index cc660fb6b31f4f06d1d7f26ac3502a1a47930821..76e8decf5c5708126e9b093a850704c95a7883b0 100644 (file)
--- a/doc/src/sgml/ref/set.sgml
+++ b/doc/src/sgml/ref/set.sgml
@@ -1,5 +1,5 @@
 
 
@@ -207,9 +207,8 @@ SELECT setseed(value);
         
        
 
-       See  for more information
-       about time zones.  Also, 
-       has a list of the recognized names for time zones.
+       See  for more information
+       about time zones.
       
      
     
This is the main PostgreSQL git repository.