diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index 5bca7c418f..d9e4ea11b3 100644 --- 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 for a list of - time zone names that are recognized for input. + Refer to 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 ). + 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 ). 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 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 f9d65b16f3..09e7d1797a 100644 --- 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 3c956ad8eb..b3fe74fe50 100644 --- 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 cc660fb6b3..76e8decf5c 100644 --- 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.