postgresql

mirror of https://git.postgresql.org/git/postgresql.git synced 2024-08-11 09:13:22 +02:00

History

Tom Lane 5b89473d87 Add CST (China Standard Time) to our lists of timezone abbreviations. For some reason this seems to have been missed when the lists in src/timezone/tznames/ were first constructed. We can't put it in Default because of the conflict with US CST, but we should certainly list it among the alternative entries in Asia.txt. (I checked for other oversights, but all the other abbreviations that are in current use according to the IANA files seem to be accounted for.) Noted while responding to bug #12326.		2014-12-24 16:35:23 -05:00
..
data	Update time zone data files to tzdata release 2014j.	2014-11-17 12:09:12 -05:00
tznames	Add CST (China Standard Time) to our lists of timezone abbreviations.	2014-12-24 16:35:23 -05:00
.gitignore	Semi-automatically detect changes in timezone abbreviations.	2013-03-23 19:17:44 -04:00
ialloc.c	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
known_abbrevs.txt	Update time zone data files to tzdata release 2014j.	2014-11-17 12:09:12 -05:00
localtime.c	Support timezone abbreviations that sometimes change.	2014-10-16 15:22:10 -04:00
Makefile	Finish adding file version information to installed Windows binaries.	2014-08-18 22:59:53 -04:00
pgtz.c	Reject out-of-range numeric timezone specifications.	2014-07-21 22:41:20 -04:00
pgtz.h	Update copyright for 2014	2014-01-07 16:05:30 -05:00
private.h	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
README	Rename 'gmake' to 'make' in docs and recommended commands	2014-02-12 17:29:19 -05:00
scheck.c	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
strftime.c	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
tzfile.h	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
zic.c	Support timezone abbreviations that sometimes change.	2014-10-16 15:22:10 -04:00

README

src/timezone/README

Timezone
========

This is a PostgreSQL adapted version of the timezone library from
http://www.iana.org/time-zones

The source code can be found at:

	ftp://ftp.iana.org/tz/releases/tzcode*.tar.gz

The code is currently synced with release 2010c.  There are many cosmetic
(and not so cosmetic) differences from the original tzcode library, but
diffs in the upstream version should usually be propagated to our version.

The data files under data/ are an exact copy of the latest data set from:

	ftp://ftp.iana.org/tz/releases/tzdata*.tar.gz

Since time zone rules change frequently in some parts of the world,
we should endeavor to update the data files before each PostgreSQL
release.

While the files under data/ can just be duplicated when updating, manual
effort is needed to update the time zone abbreviation lists under tznames/.
These need to be changed whenever new abbreviations are invented or the
UTC offset associated with an existing abbreviation changes.  To detect
if this has happened, after installing new files under data/ do
	make abbrevs.txt
which will produce a file showing all abbreviations that are in current
use according to the data/ files.  Compare this to known_abbrevs.txt,
which is the list that existed last time the tznames/ files were updated.
Update tznames/ as seems appropriate, then replace known_abbrevs.txt
in the same commit.

When there has been a new release of Windows (probably including Service
Packs), the list of matching timezones need to be updated. Run the
script in src/tools/win32tzlist.pl on a Windows machine running this new
release and apply any new timezones that it detects. Never remove any
mappings in case they are removed in Windows, since we still need to
match properly on the old version.