Future-proof regression tests against possibly-missing posixrules file.
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 19 Jun 2020 17:55:21 +0000 (13:55 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 19 Jun 2020 17:55:36 +0000 (13:55 -0400)
commit2c8ef9363db199aed9e8f17edba866b1215803c6
tree077386b37b661f5de13a69e3bc839758264025f0
parent816cbb59e3008112c5b217af7b9213b7a09881bf
Future-proof regression tests against possibly-missing posixrules file.

The IANA time zone folk have deprecated use of a "posixrules" file in
the tz database.  While for now it's our choice whether to keep
supplying one in our own builds, installations built with
--with-system-tzdata will soon be needing to cope with that file not
being present, at least on some platforms.

This causes a problem for the horology test, which expected the
nonstandard POSIX zone spec "CST7CDT" to apply pre-2007 US daylight
savings rules.  That does happen if the posixrules file supplies such
information, but otherwise the test produces undesired results.
To fix, add an explicit transition date rule that matches 2005 practice.
(We could alternatively have switched the test to use some real time
zone, but it seems useful to have coverage of this type of zone spec.)

While at it, update a documentation example that also relied on
"CST7CDT"; use a real-world zone name instead.  Also, document why
the zone names EST5EDT, CST6CDT, MST7MDT, PST8PDT aren't subject to
similar failures when "posixrules" is missing.

Back-patch to all supported branches, since the hazard is the same
for all.

Discussion: https://postgr.es/m/1665379.1592581287@sss.pgh.pa.us
doc/src/sgml/datetime.sgml
doc/src/sgml/func.sgml
src/test/regress/expected/horology.out
src/test/regress/sql/horology.sql