From 8cd571b202ba60bf5b8fd150349cf6c92edfa797 Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Sun, 6 Apr 2003 17:47:24 +0000
Subject: [PATCH] Clarify exactly when DST-changeover-induced regression test
failures can be expected to occur.
---
doc/src/sgml/regress.sgml | 20 ++++++++++++++++----
1 file changed, 16 insertions(+), 4 deletions(-)
diff --git a/doc/src/sgml/regress.sgml b/doc/src/sgml/regress.sgml
index 8c0df408783..a5dac7a1411 100644
--- a/doc/src/sgml/regress.sgml
+++ b/doc/src/sgml/regress.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/regress.sgml,v 1.31 2003/03/13 01:30:29 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/regress.sgml,v 1.32 2003/04/06 17:47:24 tgl Exp $ -->
<chapter id="regress">
<title id="regress-title">Regression Tests</title>
@@ -201,14 +201,26 @@ gmake installcheck
<title>Date and time differences</title>
<para>
- Some of the queries in the <filename>horology</filename> test will
+ A few of the queries in the <filename>horology</filename> test will
fail if you run the test on the day of a daylight-saving time
- changeover, or the day before or after one. These queries assume
- that the intervals between midnight yesterday, midnight today and
+ changeover, or the day after one. These queries expect that
+ the intervals between midnight yesterday, midnight today and
midnight tomorrow are exactly twenty-four hours --- which is wrong
if daylight-saving time went into or out of effect meanwhile.
</para>
+ <note>
+ <para>
+ Because USA daylight-saving rules are used, this problem always
+ occurs on the first Sunday of April, the last Sunday of October,
+ and their following Mondays, regardless of when daylight-saving
+ is in effect where you live. Also note that the problem appears or
+ disappears at midnight Pacific time (UTC-7 or UTC-8), not midnight
+ your local time. Thus the failure may appear late on Saturday or
+ persist through much of Tuesday, depending on where you live.
+ </para>
+ </note>
+
<para>
Most of the date and time results are dependent on the time zone
environment. The reference files are generated for time zone
--
GitLab