]> git.ipfire.org Git - thirdparty/postgresql.git/commit
Doc: document POSIX-style time zone specifications in full.
authorTom Lane <tgl@sss.pgh.pa.us>
Thu, 18 Jun 2020 20:27:18 +0000 (16:27 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Thu, 18 Jun 2020 20:27:41 +0000 (16:27 -0400)
commitc10dc2d11791cc18ceea78caa94eb4b651090259
treedb21653c251c649caad2bd3cc6ab2a085755f345
parent43e70addf5a65f1b99c286f82e2e4970b0c2fda7
Doc: document POSIX-style time zone specifications in full.

We'd glossed over most of this complexity for years, but it's hard
to avoid writing it all down now, so that we can explain what happens
when there's no "posixrules" file in the IANA time zone database.
That was at best a tiny minority situation till now, but it's likely
to become quite common in the future, so we'd better explain it.

Nonetheless, we don't really encourage people to use POSIX zone specs;
picking a named zone is almost always what you really want, unless
perhaps you're stuck with an out-of-date zone database.  Therefore,
let's shove all this detail into an appendix.

Patch by me; thanks to Robert Haas for help with some awkward wording.

Discussion: https://postgr.es/m/1390.1562258309@sss.pgh.pa.us
doc/src/sgml/datatype.sgml
doc/src/sgml/datetime.sgml