Insulate doc against N. American timezone changes

Recent changes to the meaning of "Pacific Time" in western Canada, along
with possible broader changes to US timekeeping in the US Sunshine
Protection bill (H.R. 139), make it advisable to avoid using examples
like "PST" in Emacs documentation as these abbreviations are too likely
to be ambiguous.  Use more-stable abbreviations like "IST" and "JST".
This commit is contained in:
Paul Eggert 2026-07-23 11:28:04 -07:00
parent b1a5151dbb
commit 53e564eebb
5 changed files with 15 additions and 13 deletions

View file

@ -1534,9 +1534,10 @@ in.
The value has the form @code{(@var{offset} @var{abbr})}. Here
@var{offset} is an integer giving the number of seconds ahead of Universal Time
(east of Greenwich). A negative value means west of Greenwich. The
second element, @var{abbr}, is a string giving an abbreviation for the
time zone, e.g., @samp{"CST"} for China Standard Time or for
U.S. Central Standard Time. Both elements can change when daylight
second element, @var{abbr}, is a string giving a possibly-ambiguous
abbreviation for the time zone, e.g., @samp{"IST"} for India Standard
Time, Irish Standard Time, or Israel Standard Time.
Both elements can change when daylight
saving time begins or ends; if the user has specified a time zone that
does not use a seasonal time adjustment, then the value is constant
through time.
@ -1981,7 +1982,7 @@ This stands for the year without century (00--99).
@item %Y
This stands for the year with century.
@item %Z
This stands for the time zone abbreviation (e.g., @samp{EST}).
This stands for the time zone abbreviation (e.g., @samp{IST}).
@item %z
This stands for the time zone numerical offset. The @samp{z} can be
preceded by one, two, or three colons; if plain @samp{%z} stands for

View file

@ -17367,8 +17367,8 @@ and @kbd{t U}, the normal argument is then taken from the second-to-top
stack position.) This allows you to give a non-integer time zone
adjustment. The time-zone argument can also be an HMS form, or
it can be a variable which is a time zone name in upper- or lower-case.
For example @samp{tzone(PST) = tzone(8)} and @samp{tzone(pdt) = tzone(7)}
(for Pacific standard and daylight saving times, respectively).
For example @samp{tzone(JST) = tzone(-9)} and @samp{tzone(gmt) = tzone(0)}
(for Japan standard and Greenwich mean time, respectively).
North American and European time zone names are defined as follows.
These names are obsolescent and new code should not rely on them:
@ -17399,13 +17399,13 @@ To define time zone names that do not appear in the above table,
you must modify the Lisp variable @code{math-tzone-names}. This
is a list of lists describing the different time zone names; its
structure is best explained by an example. The three entries for
circa-2025 US Pacific Time look like this:
circa-2026 time in Sydney, Australia might look like this:
@smallexample
@group
( ( "PST" 8 0 ) ; Name as an upper-case string, then standard
( "PDT" 8 -1 ) ; adjustment, then daylight saving adjustment.
( "PGT" 8 "PST" "PDT" ) ) ; Generalized time zone.
(("AEST" -10 0) ; Name as an upper-case string, then standard
("AEDT" -10 -1) ; adjustment, then daylight saving adjustment.
("AEGT" -10 "AEST" "AEDT")) ; Generalized time zone.
@end group
@end smallexample

View file

@ -150,7 +150,7 @@ This string specifies the format of the timestamp being echoed in
the minibuffer."
:type '(choice (const :tag "Timestamped Monday, 15:04:05"
"Timestamped %A, %H:%M:%S")
(const :tag "2006-01-02 15:04:05 MST" "%F %T %Z")
(const :tag "2026-07-21 15:04:05 JST" "%F %T %Z")
string))
(defcustom erc-echo-timestamp-zone nil

View file

@ -345,7 +345,8 @@ all. This may very well take some time.")
;; The list of time zone values is obsolescent, and new code should
;; not rely on it. Many of the time zone abbreviations are wrong;
;; in particular, all single-letter abbreviations other than "Z" have
;; been wrong since Internet RFC 2822 (2001). However, the
;; been wrong since Internet RFC 2822 (2001), and abbreviations like "PST"
;; do not match current practice in some locations. However, the
;; abbreviations have not been changed due to backward compatibility
;; concerns.
)

View file

@ -57,7 +57,7 @@ with %, which are converted as follows:
%S seconds
%w day number of week, Sunday is 0
%Y 4-digit year %y 2-digit year
%Z time zone name: `EST'
%Z time zone name: `JST'
%-z zone offset with hour: `-08' %:::z adds colons as needed: `+05:30'
%5z zone offset with mins: `-0800' %:z adds colon: `-08:00'