Mercurial > emacs
annotate lisp/calendar/cal-dst.el @ 92905:0cea6abac18e
(french-calendar-accents): Move definition after constants.
(french-calendar-epoch, calendar-goto-french-date): Doc fix.
(french-calendar-month-name-array)
(french-calendar-multibyte-month-name-array)
(french-calendar-day-name-array, french-calendar-special-days-array):
Add doc strings.
author | Glenn Morris <rgm@gnu.org> |
---|---|
date | Fri, 14 Mar 2008 03:14:59 +0000 |
parents | 770f4a93480e |
children | 83321455f486 |
rev | line source |
---|---|
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
1 ;;; cal-dst.el --- calendar functions for daylight saving rules |
3872 | 2 |
68721 | 3 ;; Copyright (C) 1993, 1994, 1995, 1996, 2001, 2002, 2003, 2004, 2005, |
79703 | 4 ;; 2006, 2007, 2008 Free Software Foundation, Inc. |
3872 | 5 |
6 ;; Author: Paul Eggert <eggert@twinsun.com> | |
92850 | 7 ;; Edward M. Reingold <reingold@cs.uiuc.edu> |
67465
a55ee709ec8d
Update copyright pending Emacs 22.
Glenn Morris <rgm@gnu.org>
parents:
64085
diff
changeset
|
8 ;; Maintainer: Glenn Morris <rgm@gnu.org> |
3872 | 9 ;; Keywords: calendar |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
10 ;; Human-Keywords: daylight saving time, calendar, diary, holidays |
3872 | 11 |
12 ;; This file is part of GNU Emacs. | |
13 | |
6736
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
14 ;; GNU Emacs is free software; you can redistribute it and/or modify |
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
15 ;; it under the terms of the GNU General Public License as published by |
78216
93e11478c954
Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents:
77277
diff
changeset
|
16 ;; the Free Software Foundation; either version 3, or (at your option) |
6736
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
17 ;; any later version. |
3872 | 18 |
6736
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
19 ;; GNU Emacs is distributed in the hope that it will be useful, |
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of |
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
22 ;; GNU General Public License for more details. |
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
23 |
3e1323443b1a
Fix copying conditions for current GPL version.
Richard M. Stallman <rms@gnu.org>
parents:
6735
diff
changeset
|
24 ;; You should have received a copy of the GNU General Public License |
14169 | 25 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
64085 | 26 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
27 ;; Boston, MA 02110-1301, USA. | |
3872 | 28 |
29 ;;; Commentary: | |
30 | |
31 ;; This collection of functions implements the features of calendar.el and | |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
32 ;; holiday.el that deal with daylight saving time. |
3872 | 33 |
34 ;;; Code: | |
35 | |
36 (require 'calendar) | |
16726
475649bca297
(calendar-time-zone-daylight-rules): Add support
Paul Eggert <eggert@twinsun.com>
parents:
14169
diff
changeset
|
37 (require 'cal-persia) |
3872 | 38 |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
39 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
40 (defgroup calendar-dst nil |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
41 "Options related to Daylight Saving Time." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
42 :prefix "calendar-" |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
43 :group 'calendar) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
44 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
45 |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
46 (defcustom calendar-dst-check-each-year-flag t |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
47 "Non-nil means to check each year for DST transitions as needed. |
73894
cfa3c02ad6bf
(calendar-dst-check-each-year-flag): Avoid
Andreas Schwab <schwab@suse.de>
parents:
73875
diff
changeset
|
48 Otherwise assume the next two transitions found after the |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
49 current date apply to all years. This is faster, but not always |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
50 correct, since the dates of daylight saving transitions sometimes |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
51 change." |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
52 :type 'boolean |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
53 :version "22.1" |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
54 :group 'calendar) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
55 |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
56 ;;;###autoload |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
57 (put 'calendar-daylight-savings-starts 'risky-local-variable t) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
58 (defcustom calendar-daylight-savings-starts '(calendar-dst-starts year) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
59 "Sexp giving the date on which daylight saving time starts. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
60 This is an expression in the variable `year' whose value gives the Gregorian |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
61 date in the form (month day year) on which daylight saving time starts. It is |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
62 used to determine the starting date of daylight saving time for the holiday |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
63 list and for correcting times of day in the solar and lunar calculations. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
64 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
65 For example, if daylight saving time is mandated to start on October 1, |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
66 you would set `calendar-daylight-savings-starts' to |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
67 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
68 '(10 1 year) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
69 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
70 If it starts on the first Sunday in April, you would set it to |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
71 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
72 '(calendar-nth-named-day 1 0 4 year) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
73 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
74 If the locale never uses daylight saving time, set this to nil." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
75 :type 'sexp |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
76 :group 'calendar-dst) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
77 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
78 ;;;###autoload |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
79 (put 'calendar-daylight-savings-ends 'risky-local-variable t) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
80 (defcustom calendar-daylight-savings-ends '(calendar-dst-ends year) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
81 "Sexp giving the date on which daylight saving time ends. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
82 This is an expression in the variable `year' whose value gives the Gregorian |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
83 date in the form (month day year) on which daylight saving time ends. It is |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
84 used to determine the starting date of daylight saving time for the holiday |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
85 list and for correcting times of day in the solar and lunar calculations. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
86 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
87 For example, if daylight saving time ends on the last Sunday in October: |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
88 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
89 '(calendar-nth-named-day -1 0 10 year) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
90 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
91 If the locale never uses daylight saving time, set this to nil." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
92 :type 'sexp |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
93 :group 'calendar-dst) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
94 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
95 ;;; More defcustoms below. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
96 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
97 |
3872 | 98 (defvar calendar-current-time-zone-cache nil |
74870
06cc5e77c85a
(calendar-dst-starts): Default to second Sunday in March.
Richard M. Stallman <rms@gnu.org>
parents:
73894
diff
changeset
|
99 "Cache for result of `calendar-current-time-zone'.") |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
100 (put 'calendar-current-time-zone-cache 'risky-local-variable t) ; why? |
3872 | 101 |
102 (defvar calendar-system-time-basis | |
103 (calendar-absolute-from-gregorian '(1 1 1970)) | |
104 "Absolute date of starting date of system clock.") | |
105 | |
106 (defun calendar-absolute-from-time (x utc-diff) | |
107 "Absolute local date of time X; local time is UTC-DIFF seconds from UTC. | |
108 | |
109 X is (HIGH . LOW) or (HIGH LOW . IGNORED) where HIGH and LOW are the | |
110 high and low 16 bits, respectively, of the number of seconds since | |
111 1970-01-01 00:00:00 UTC, ignoring leap seconds. | |
112 | |
113 Returns the pair (ABS-DATE . SECONDS) where SECONDS after local midnight on | |
114 absolute date ABS-DATE is the equivalent moment to X." | |
115 (let* ((h (car x)) | |
92850 | 116 (xtail (cdr x)) |
3872 | 117 (l (+ utc-diff (if (numberp xtail) xtail (car xtail)))) |
4535 | 118 (u (+ (* 512 (mod h 675)) (floor l 128)))) |
3872 | 119 ;; Overflow is a terrible thing! |
120 (cons (+ calendar-system-time-basis | |
92850 | 121 ;; floor((2^16 h +l) / (60*60*24)) |
122 (* 512 (floor h 675)) (floor u 675)) | |
123 ;; (2^16 h +l) mod (60*60*24) | |
124 (+ (* (mod u 675) 128) (mod l 128))))) | |
3872 | 125 |
126 (defun calendar-time-from-absolute (abs-date s) | |
127 "Time of absolute date ABS-DATE, S seconds after midnight. | |
128 | |
56425
5572efece9a6
(calendar-time-from-absolute): Return a list of two integers, instead
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
129 Returns the list (HIGH LOW) where HIGH and LOW are the high and low |
3872 | 130 16 bits, respectively, of the number of seconds 1970-01-01 00:00:00 UTC, |
131 ignoring leap seconds, that is the equivalent moment to S seconds after | |
132 midnight UTC on absolute date ABS-DATE." | |
133 (let* ((a (- abs-date calendar-system-time-basis)) | |
4535 | 134 (u (+ (* 163 (mod a 512)) (floor s 128)))) |
3872 | 135 ;; Overflow is a terrible thing! |
56425
5572efece9a6
(calendar-time-from-absolute): Return a list of two integers, instead
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
136 (list |
5001
f3a55af8f584
(calendar-absolute-from-time): Undo Sep 14 patch.
Richard M. Stallman <rms@gnu.org>
parents:
4756
diff
changeset
|
137 ;; floor((60*60*24*a + s) / 2^16) |
4535 | 138 (+ a (* 163 (floor a 512)) (floor u 512)) |
5001
f3a55af8f584
(calendar-absolute-from-time): Undo Sep 14 patch.
Richard M. Stallman <rms@gnu.org>
parents:
4756
diff
changeset
|
139 ;; (60*60*24*a + s) mod 2^16 |
4535 | 140 (+ (* 128 (mod u 512)) (mod s 128))))) |
3872 | 141 |
142 (defun calendar-next-time-zone-transition (time) | |
143 "Return the time of the next time zone transition after TIME. | |
92640
21bbfdf10ce1
(calendar-next-time-zone-transition, calendar-time-zone): Doc fixes.
Glenn Morris <rgm@gnu.org>
parents:
92581
diff
changeset
|
144 Both TIME and the result are acceptable arguments to `current-time-zone'. |
3872 | 145 Return nil if no such transition can be found." |
92850 | 146 (let* ((base 65536) ;; 2^16 = base of current-time output |
147 (quarter-multiple 120) ;; approx = (seconds per quarter year) / base | |
148 (time-zone (current-time-zone time)) | |
149 (time-utc-diff (car time-zone)) | |
3872 | 150 hi |
92850 | 151 hi-zone |
3872 | 152 (hi-utc-diff time-utc-diff) |
153 (quarters '(2 1 3))) | |
154 ;; Heuristic: probe the time zone offset in the next three calendar | |
155 ;; quarters, looking for a time zone offset different from TIME. | |
156 (while (and quarters (eq time-utc-diff hi-utc-diff)) | |
157 (setq hi (cons (+ (car time) (* (car quarters) quarter-multiple)) 0)) | |
158 (setq hi-zone (current-time-zone hi)) | |
159 (setq hi-utc-diff (car hi-zone)) | |
160 (setq quarters (cdr quarters))) | |
161 (and | |
162 time-utc-diff | |
163 hi-utc-diff | |
164 (not (eq time-utc-diff hi-utc-diff)) | |
165 ;; Now HI is after the next time zone transition. | |
166 ;; Set LO to TIME, and then binary search to increase LO and decrease HI | |
167 ;; until LO is just before and HI is just after the time zone transition. | |
168 (let* ((tail (cdr time)) | |
92850 | 169 (lo (cons (car time) (if (numberp tail) tail (car tail)))) |
170 probe) | |
3872 | 171 (while |
92850 | 172 ;; Set PROBE to halfway between LO and HI, rounding down. |
173 ;; If PROBE equals LO, we are done. | |
174 (let* ((lsum (+ (cdr lo) (cdr hi))) | |
175 (hsum (+ (car lo) (car hi) (/ lsum base))) | |
176 (hsumodd (logand 1 hsum))) | |
177 (setq probe (cons (/ (- hsum hsumodd) 2) | |
178 (/ (+ (* hsumodd base) (% lsum base)) 2))) | |
179 (not (equal lo probe))) | |
180 ;; Set either LO or HI to PROBE, depending on probe results. | |
181 (if (eq (car (current-time-zone probe)) hi-utc-diff) | |
182 (setq hi probe) | |
183 (setq lo probe))) | |
3872 | 184 hi)))) |
185 | |
186 (defun calendar-time-zone-daylight-rules (abs-date utc-diff) | |
187 "Return daylight transition rule for ABS-DATE, UTC-DIFF sec offset from UTC. | |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
188 ABS-DATE must specify a day that contains a daylight saving transition. |
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
189 The result has the proper form for `calendar-daylight-savings-starts'." |
3872 | 190 (let* ((date (calendar-gregorian-from-absolute abs-date)) |
92850 | 191 (weekday (% abs-date 7)) |
192 (m (extract-calendar-month date)) | |
193 (d (extract-calendar-day date)) | |
194 (y (extract-calendar-year date)) | |
3872 | 195 (last (calendar-last-day-of-month m y)) |
92850 | 196 (candidate-rules |
197 (append | |
198 ;; Day D of month M. | |
199 (list (list 'list m d 'year)) | |
200 ;; The first WEEKDAY of month M. | |
3872 | 201 (if (< d 8) |
202 (list (list 'calendar-nth-named-day 1 weekday m 'year))) | |
92850 | 203 ;; The last WEEKDAY of month M. |
3872 | 204 (if (> d (- last 7)) |
205 (list (list 'calendar-nth-named-day -1 weekday m 'year))) | |
92850 | 206 ;; The first WEEKDAY after day J of month M, for D-6 < J <= D. |
3872 | 207 (let (l) |
208 (calendar-for-loop j from (max 2 (- d 6)) to (min d (- last 8)) do | |
92850 | 209 (setq l |
210 (cons | |
211 (list 'calendar-nth-named-day | |
212 1 weekday m 'year j) | |
213 l))) | |
214 l) | |
215 ;; 01-01 and 07-01 for this year's Persian calendar. | |
216 (if (and (= m 3) (<= 20 d) (<= d 21)) | |
217 '((calendar-gregorian-from-absolute | |
218 (calendar-absolute-from-persian | |
219 (list 1 1 (- year 621)))))) | |
220 (if (and (= m 9) (<= 22 d) (<= d 23)) | |
221 '((calendar-gregorian-from-absolute | |
222 (calendar-absolute-from-persian | |
223 (list 7 1 (- year 621)))))))) | |
224 (prevday-sec (- -1 utc-diff)) ;; last sec of previous local day | |
225 (year (1+ y))) | |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
226 ;; Scan through the next few years until only one rule remains. |
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
227 (while |
92850 | 228 (let ((rules candidate-rules) |
229 new-rules) | |
230 (while | |
231 (let* | |
232 ((rule (car rules)) | |
233 (date | |
234 ;; The following is much faster than | |
235 ;; (calendar-absolute-from-gregorian (eval rule)). | |
236 (cond ((eq (car rule) 'calendar-nth-named-day) | |
237 (eval (cons 'calendar-nth-named-absday (cdr rule)))) | |
238 ((eq (car rule) 'calendar-gregorian-from-absolute) | |
239 (eval (car (cdr rule)))) | |
240 (t (let ((g (eval rule))) | |
241 (calendar-absolute-from-gregorian g)))))) | |
242 (or (equal | |
243 (current-time-zone | |
244 (calendar-time-from-absolute date prevday-sec)) | |
245 (current-time-zone | |
246 (calendar-time-from-absolute (1+ date) prevday-sec))) | |
247 (setq new-rules (cons rule new-rules))) | |
248 (setq rules (cdr rules)))) | |
249 ;; If no rules remain, just use the first candidate rule; | |
250 ;; it's wrong in general, but it's right for at least one year. | |
251 (setq candidate-rules (if new-rules (nreverse new-rules) | |
252 (list (car candidate-rules)))) | |
253 (setq year (1+ year)) | |
254 (cdr candidate-rules))) | |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
255 (car candidate-rules))) |
3872 | 256 |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
257 ;; TODO it might be better to extract this information directly from |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
258 ;; the system timezone database. But cross-platform...? |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
259 ;; See thread |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
260 ;; http://lists.gnu.org/archive/html/emacs-pretest-bug/2006-11/msg00060.html |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
261 (defun calendar-dst-find-data (&optional time) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
262 "Find data on the first daylight saving time transitions after TIME. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
263 TIME defaults to `current-time'. Return value is as described |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
264 for `calendar-current-time-zone'." |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
265 (let* ((t0 (or time (current-time))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
266 (t0-zone (current-time-zone t0)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
267 (t0-utc-diff (car t0-zone)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
268 (t0-name (car (cdr t0-zone)))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
269 (if (not t0-utc-diff) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
270 ;; Little or no time zone information is available. |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
271 (list nil nil t0-name t0-name nil nil nil nil) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
272 (let* ((t1 (calendar-next-time-zone-transition t0)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
273 (t2 (and t1 (calendar-next-time-zone-transition t1)))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
274 (if (not t2) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
275 ;; This locale does not have daylight saving time. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
276 (list (/ t0-utc-diff 60) 0 t0-name t0-name nil nil 0 0) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
277 ;; Use heuristics to find daylight saving parameters. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
278 (let* ((t1-zone (current-time-zone t1)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
279 (t1-utc-diff (car t1-zone)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
280 (t1-name (car (cdr t1-zone))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
281 (t1-date-sec (calendar-absolute-from-time t1 t0-utc-diff)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
282 (t2-date-sec (calendar-absolute-from-time t2 t1-utc-diff)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
283 ;; TODO When calendar-dst-check-each-year-flag is non-nil, |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
284 ;; the rules can be simpler than they currently are. |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
285 (t1-rules (calendar-time-zone-daylight-rules |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
286 (car t1-date-sec) t0-utc-diff)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
287 (t2-rules (calendar-time-zone-daylight-rules |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
288 (car t2-date-sec) t1-utc-diff)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
289 (t1-time (/ (cdr t1-date-sec) 60)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
290 (t2-time (/ (cdr t2-date-sec) 60))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
291 (cons |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
292 (/ (min t0-utc-diff t1-utc-diff) 60) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
293 (cons |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
294 (/ (abs (- t0-utc-diff t1-utc-diff)) 60) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
295 (if (< t0-utc-diff t1-utc-diff) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
296 (list t0-name t1-name t1-rules t2-rules t1-time t2-time) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
297 (list t1-name t0-name t2-rules t1-rules t2-time t1-time) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
298 ))))))))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
299 |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
300 (defvar calendar-dst-transition-cache nil |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
301 "Internal cal-dst variable storing date of daylight saving time transitions. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
302 Value is a list with elements of the form (YEAR START END), where |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
303 START and END are expressions that when evaluated return the |
92640
21bbfdf10ce1
(calendar-next-time-zone-transition, calendar-time-zone): Doc fixes.
Glenn Morris <rgm@gnu.org>
parents:
92581
diff
changeset
|
304 start and end dates (respectively) for DST in YEAR. Used by the |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
305 function `calendar-dst-find-startend'.") |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
306 |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
307 (defun calendar-dst-find-startend (year) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
308 "Find the dates in YEAR on which daylight saving time starts and ends. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
309 Returns a list (YEAR START END), where START and END are |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
310 expressions that when evaluated return the start and end dates, |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
311 respectively. This function first attempts to use pre-calculated |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
312 data from `calendar-dst-transition-cache', otherwise it calls |
77277
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
313 `calendar-dst-find-data' (and adds the results to the cache). |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
314 If dates in YEAR cannot be handled by `encode-time' (e.g. if they |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
315 are too large to be represented as a lisp integer), then rather |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
316 than an error this function returns the result appropriate for |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
317 the current year." |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
318 (let ((e (assoc year calendar-dst-transition-cache)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
319 f) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
320 (or e |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
321 (progn |
77277
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
322 (setq e (calendar-dst-find-data |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
323 (condition-case nil |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
324 (encode-time 1 0 0 1 1 year) |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
325 (error |
c56fcbc72ab0
(calendar-dst-find-startend): If YEAR cannot be encoded, fall back to
Glenn Morris <rgm@gnu.org>
parents:
76476
diff
changeset
|
326 (encode-time 1 0 0 1 1 (nth 5 (decode-time)))))) |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
327 f (nth 4 e) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
328 e (list year f (nth 5 e)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
329 calendar-dst-transition-cache |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
330 (append calendar-dst-transition-cache (list e))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
331 e)))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
332 |
3872 | 333 (defun calendar-current-time-zone () |
334 "Return UTC difference, dst offset, names and rules for current time zone. | |
335 | |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
336 Returns (UTC-DIFF DST-OFFSET STD-ZONE DST-ZONE DST-STARTS DST-ENDS |
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
337 DST-STARTS-TIME DST-ENDS-TIME), based on a heuristic probing of what the |
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
338 system knows: |
3872 | 339 |
340 UTC-DIFF is an integer specifying the number of minutes difference between | |
341 standard time in the current time zone and Coordinated Universal Time | |
342 (Greenwich Mean Time). A negative value means west of Greenwich. | |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
343 DST-OFFSET is an integer giving the daylight saving time offset in minutes. |
3872 | 344 STD-ZONE is a string giving the name of the time zone when no seasonal time |
345 adjustment is in effect. | |
346 DST-ZONE is a string giving the name of the time zone when there is a seasonal | |
347 time adjustment in effect. | |
348 DST-STARTS and DST-ENDS are sexps in the variable `year' giving the daylight | |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
349 saving time start and end rules, in the form expected by |
3872 | 350 `calendar-daylight-savings-starts'. |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
351 DST-STARTS-TIME and DST-ENDS-TIME are integers giving the number of minutes |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
352 after midnight that daylight saving time starts and ends. |
3872 | 353 |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
354 If the local area does not use a seasonal time adjustment, STD-ZONE and |
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
355 DST-ZONE are equal, and all the DST-* integer variables are 0. |
3872 | 356 |
357 Some operating systems cannot provide all this information to Emacs; in this | |
358 case, `calendar-current-time-zone' returns a list containing nil for the data | |
359 it can't find." | |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
360 (unless calendar-current-time-zone-cache |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
361 (setq calendar-current-time-zone-cache (calendar-dst-find-data)))) |
3872 | 362 |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
363 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
364 ;; Following options should be set based on conditions when the code |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
365 ;; is invoked, so are not suitable for dumping into loaddefs.el. They |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
366 ;; default to US Eastern time if time zone info is not available. |
3872 | 367 |
368 (calendar-current-time-zone) | |
369 | |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
370 (defcustom calendar-time-zone (or (car calendar-current-time-zone-cache) -300) |
92640
21bbfdf10ce1
(calendar-next-time-zone-transition, calendar-time-zone): Doc fixes.
Glenn Morris <rgm@gnu.org>
parents:
92581
diff
changeset
|
371 "Number of minutes difference between local standard time and UTC. |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
372 For example, -300 for New York City, -480 for Los Angeles." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
373 :type 'integer |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
374 :group 'calendar-dst) |
3872 | 375 |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
376 (defcustom calendar-daylight-time-offset |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
377 (or (car (cdr calendar-current-time-zone-cache)) 60) |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
378 "Number of minutes difference between daylight saving and standard time. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
379 If the locale never uses daylight saving time, set this to 0." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
380 :type 'integer |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
381 :group 'calendar-dst) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
38422
diff
changeset
|
382 |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
383 (defcustom calendar-standard-time-zone-name |
4659
031aaf217dc3
(calendar-time-zone-daylight-rules): Scan through the
Paul Eggert <eggert@twinsun.com>
parents:
4535
diff
changeset
|
384 (or (car (nthcdr 2 calendar-current-time-zone-cache)) "EST") |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
385 "Abbreviated name of standard time zone at `calendar-location-name'. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
386 For example, \"EST\" in New York City, \"PST\" for Los Angeles." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
387 :type 'string |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
388 :group 'calendar-dst) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
389 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
390 (defcustom calendar-daylight-time-zone-name |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
391 (or (car (nthcdr 3 calendar-current-time-zone-cache)) "EDT") |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
392 "Abbreviated name of daylight saving time zone at `calendar-location-name'. |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
393 For example, \"EDT\" in New York City, \"PDT\" for Los Angeles." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
394 :type 'string |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
395 :group 'calendar-dst) |
3872 | 396 |
92552
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
397 (defcustom calendar-daylight-savings-starts-time |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
398 (or (car (nthcdr 6 calendar-current-time-zone-cache)) 120) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
399 "Number of minutes after midnight that daylight saving time starts." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
400 :type 'integer |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
401 :group 'calendar-dst) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
402 |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
403 (defcustom calendar-daylight-savings-ends-time |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
404 (or (car (nthcdr 7 calendar-current-time-zone-cache)) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
405 calendar-daylight-savings-starts-time) |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
406 "Number of minutes after midnight that daylight saving time ends." |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
407 :type 'integer |
19c69f1fd028
(calendar-dst): New custom group.
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
408 :group 'calendar-dst) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
38422
diff
changeset
|
409 |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
410 |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
411 (defun calendar-dst-starts (year) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
412 "Return the date of YEAR on which daylight saving time starts. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
413 This function respects the value of `calendar-dst-check-each-year-flag'." |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
414 (or (let ((expr (if calendar-dst-check-each-year-flag |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
415 (cadr (calendar-dst-find-startend year)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
416 (nth 4 calendar-current-time-zone-cache)))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
417 (if expr (eval expr))) |
92850 | 418 ;; New US rules commencing 2007. ftp://elsie.nci.nih.gov/pub/. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
419 (and (not (zerop calendar-daylight-time-offset)) |
74870
06cc5e77c85a
(calendar-dst-starts): Default to second Sunday in March.
Richard M. Stallman <rms@gnu.org>
parents:
73894
diff
changeset
|
420 (calendar-nth-named-day 2 0 3 year)))) |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
421 |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
422 (defun calendar-dst-ends (year) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
423 "Return the date of YEAR on which daylight saving time ends. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
424 This function respects the value of `calendar-dst-check-each-year-flag'." |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
425 (or (let ((expr (if calendar-dst-check-each-year-flag |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
426 (nth 2 (calendar-dst-find-startend year)) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
427 (nth 5 calendar-current-time-zone-cache)))) |
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
428 (if expr (eval expr))) |
92850 | 429 ;; New US rules commencing 2007. ftp://elsie.nci.nih.gov/pub/. |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
430 (and (not (zerop calendar-daylight-time-offset)) |
74870
06cc5e77c85a
(calendar-dst-starts): Default to second Sunday in March.
Richard M. Stallman <rms@gnu.org>
parents:
73894
diff
changeset
|
431 (calendar-nth-named-day 1 0 11 year)))) |
73875
be323d585de0
Do not assume DST starts/ends on the same date in every year.
Glenn Morris <rgm@gnu.org>
parents:
68721
diff
changeset
|
432 |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
433 (defun dst-in-effect (date) |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
434 "True if on absolute DATE daylight saving time is in effect. |
13686
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
435 Fractional part of DATE is local standard time of day." |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
436 (let* ((year (extract-calendar-year |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
437 (calendar-gregorian-from-absolute (floor date)))) |
13686
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
438 (dst-starts-gregorian (eval calendar-daylight-savings-starts)) |
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
439 (dst-ends-gregorian (eval calendar-daylight-savings-ends)) |
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
440 (dst-starts (and dst-starts-gregorian |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
441 (+ (calendar-absolute-from-gregorian |
13686
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
442 dst-starts-gregorian) |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
443 (/ calendar-daylight-savings-starts-time |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
444 60.0 24.0)))) |
13686
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
445 (dst-ends (and dst-ends-gregorian |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
446 (+ (calendar-absolute-from-gregorian |
13686
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
447 dst-ends-gregorian) |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
448 (/ (- calendar-daylight-savings-ends-time |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
449 calendar-daylight-time-offset) |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
450 60.0 24.0))))) |
13686
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
451 (and dst-starts dst-ends |
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
452 (if (< dst-starts dst-ends) |
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
453 (and (<= dst-starts date) (< date dst-ends)) |
6e3b9c9595eb
Fixed dst-in-effect for southern hemisphere. Also made doc string clearer.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
13049
diff
changeset
|
454 (or (<= dst-starts date) (< date dst-ends)))))) |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
455 |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
456 (defun dst-adjust-time (date time &optional style) |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
457 "Adjust, to account for dst on DATE, decimal fraction standard TIME. |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
458 Returns a list (date adj-time zone) where `date' and `adj-time' are the values |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
459 adjusted for `zone'; here `date' is a list (month day year), `adj-time' is a |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
460 decimal fraction time, and `zone' is a string. |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
461 |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
462 Optional parameter STYLE forces the result time to be standard time when its |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
463 value is 'standard and daylight saving time (if available) when its value is |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
464 'daylight. |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
465 |
76476
3878691bdbb7
Change "daylight savings time" -> "daylight saving time" throughout.
Chong Yidong <cyd@stupidchicken.com>
parents:
75346
diff
changeset
|
466 Conversion to daylight saving time is done according to |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
467 `calendar-daylight-savings-starts', `calendar-daylight-savings-ends', |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
468 `calendar-daylight-savings-starts-time', |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
469 `calendar-daylight-savings-ends-time', and |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
470 `calendar-daylight-savings-offset'." |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
471 |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
472 (let* ((rounded-abs-date (+ (calendar-absolute-from-gregorian date) |
92850 | 473 (/ (round (* 60 time)) 60.0 24.0))) |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
474 (dst (dst-in-effect rounded-abs-date)) |
92850 | 475 (time-zone (if dst |
476 calendar-daylight-time-zone-name | |
477 calendar-standard-time-zone-name)) | |
478 (time (+ rounded-abs-date | |
13049
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
479 (if dst (/ calendar-daylight-time-offset 24.0 60.0) 0)))) |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
480 (list (calendar-gregorian-from-absolute (truncate time)) |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
481 (* 24.0 (- time (truncate time))) |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
482 time-zone))) |
fac816f95bd8
Minor fixes; moved some code here from other calendar files.
Edward M. Reingold <reingold@emr.cs.iit.edu>
parents:
7749
diff
changeset
|
483 |
3872 | 484 (provide 'cal-dst) |
485 | |
92581 | 486 ;; arch-tag: a141d204-213c-4ca5-bdc6-f9df3aa92aad |
3872 | 487 ;;; cal-dst.el ends here |