From 9f205ff9624b8e10b4331432c59bc732b8c1a7fe Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Sun, 7 May 2023 09:28:57 -0700 Subject: Warn against bogus TZ settings * doc/parse-datetime.texi (Specifying time zone rules): Warn against TZ="UTC=5". --- doc/parse-datetime.texi | 3 +++ 1 file changed, 3 insertions(+) (limited to 'doc') diff --git a/doc/parse-datetime.texi b/doc/parse-datetime.texi index d54d7660c8..ec0160da8e 100644 --- a/doc/parse-datetime.texi +++ b/doc/parse-datetime.texi @@ -574,6 +574,9 @@ This example uses the somewhat-confusing POSIX convention for rules. and the time zone is 7 hours west of Greenwich, and @samp{TZ="<+0530>-5:30"} says that the time zone abbreviation is @samp{+0530} and the time zone is 5 hours 30 minutes east of Greenwich. +(One should never use a setting like @samp{TZ="UTC-5"}, since +this would incorrectly imply that local time is five hours east of +Greenwich and the time zone is called ``UTC''.) Although trickier POSIX @env{TZ} settings like @samp{TZ="<-05>+5<-04>,M3.2.0/2,M11.1.0/2"} can specify some daylight saving regimes, location-based settings like -- cgit v1.2.1