diff options
Diffstat (limited to 'src/timezone/tznames/README')
| -rw-r--r-- | src/timezone/tznames/README | 25 |
1 files changed, 14 insertions, 11 deletions
diff --git a/src/timezone/tznames/README b/src/timezone/tznames/README index 6cb0ae88c93..c80caa37869 100644 --- a/src/timezone/tznames/README +++ b/src/timezone/tznames/README @@ -6,26 +6,29 @@ 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. All other files except for `Default' are -intended to override values from the `Default' set. So you might already have -a file here that serves your needs. If not, you can create your own. +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 names. +that contains the desired time zone abbreviations. -If you do not find an appropriate set of time zone names for your geographic +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 names can then be included in future releases. +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 -names that can be copied into a custom abbreviation file as needed. - -Note that these files (*.txt) are already a subset of the zic timezone -database files: we tried to list only those time zones that (according to -the zic timezone database) appear to be still in use. +abbreviations that can be copied into a custom abbreviation file as needed. +Note that these files (*.txt) are already a subset of the IANA timezone +database files: we tried to list only those time zone abbreviations that +(according to the IANA timezone database) appear to be still in use. |