postgresql/src/timezone/tznames
Tom Lane 74a20d0ab7 Update time zone data files to tzdata release 2017b.
DST law changes in Chile, Haiti, and Mongolia.  Historical corrections for
Ecuador, Kazakhstan, Liberia, and Spain.

The IANA crew continue their campaign to replace invented time zone
abbrevations with numeric GMT offsets.  This update changes numerous zones
in South America, the Pacific and Indian oceans, and some Asian and Middle
Eastern zones.  I kept these abbreviations in the tznames/ data files,
however, so that we will still accept them for input.  (We may want to
start trimming those files someday, but I think we should wait for the
upstream dust to settle before deciding what to do.)

In passing, add MESZ (Mitteleuropaeische Sommerzeit) to the tznames lists;
since we accept MEZ (Mitteleuropaeische Zeit) it seems rather strange not
to take the other one.  And fix some incorrect, or at least obsolete,
comments that certain abbreviations are not traceable to the IANA data.
2017-05-01 11:53:11 -04:00
..
Africa.txt Remove vestigial references to "zic" in favor of "IANA database". 2016-09-04 19:42:08 -04:00
America.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Antarctica.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Asia.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Atlantic.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Australia Remove vestigial references to "zic" in favor of "IANA database". 2016-09-04 19:42:08 -04:00
Australia.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Default Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Etc.txt Remove vestigial references to "zic" in favor of "IANA database". 2016-09-04 19:42:08 -04:00
Europe.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
India Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
Indian.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
Makefile Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
Pacific.txt Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00
README Update time zone data files to tzdata release 2017b. 2017-05-01 11:53:11 -04:00

src/timezone/tznames/README

tznames
=======

This directory contains files with timezone sets for PostgreSQL.  The problem
is that time zone abbreviations are not unique throughout the world and you
might find out that a time zone abbreviation in the `Default' set collides
with the one you wanted to use.  This can be fixed by selecting a timezone
set that defines the abbreviation the way you want it.  There might already
be a file here that serves your needs.  If not, you can create your own.

In order to use one of these files, you need to set

   timezone_abbreviations = 'xyz'

in any of the usual ways for setting a parameter, where xyz is the filename
that contains the desired time zone abbreviations.

If you do not find an appropriate set of abbreviations for your geographic
location supplied here, please report this to <pgsql-hackers@postgresql.org>.
Your set of time zone abbreviations can then be included in future releases.
For the time being you can always add your own set.

Typically a custom abbreviation set is made by including the `Default' set
and then adding or overriding abbreviations as necessary.  For examples,
see the `Australia' and `India' files.

The files named Africa.txt, etc, are not intended to be used directly as
time zone abbreviation files. They contain reference definitions of time zone
abbreviations that can be copied into a custom abbreviation file as needed.
These files contain most of the time zone abbreviations that were shown
in the IANA timezone database circa 2010.

However, it turns out that many of these abbreviations had simply been
invented by the IANA timezone group, and do not have currency in real-world
use.  The IANA group have changed their policy about that, and now prefer to
use numeric UTC offsets whenever there's not an abbreviation with known
real-world popularity.  A lot of these abbreviations therefore no longer
appear in the IANA data, and so are marked "obsolete" in these data files.