Mercurial > emacs
annotate lisp/calendar/cal-iso.el @ 107168:282ddc0ca465
* simple.el (save-interprogram-paste-before-kill): Doc fix.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Tue, 16 Feb 2010 09:40:45 -0500 |
parents | 1d1d5d9bd884 |
children | 280c8ae2476d 376148b31b5e |
rev | line source |
---|---|
38422
7a94f1c588c4
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
20462
diff
changeset
|
1 ;;; cal-iso.el --- calendar functions for the ISO calendar |
13053 | 2 |
92609 | 3 ;; Copyright (C) 1995, 1997, 2001, 2002, 2003, 2004, 2005, 2006, 2007, |
106815 | 4 ;; 2008, 2009, 2010 Free Software Foundation, Inc. |
13053 | 5 |
6 ;; Author: Edward M. Reingold <reingold@cs.uiuc.edu> | |
65919
5c09efcfc1d9
Update maintainer email address.
Glenn Morris <rgm@gnu.org>
parents:
65145
diff
changeset
|
7 ;; Maintainer: Glenn Morris <rgm@gnu.org> |
13053 | 8 ;; Keywords: calendar |
9 ;; Human-Keywords: ISO calendar, calendar, diary | |
10 | |
11 ;; This file is part of GNU Emacs. | |
12 | |
94653
e49abd957e81
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93844
diff
changeset
|
13 ;; GNU Emacs is free software: you can redistribute it and/or modify |
13053 | 14 ;; it under the terms of the GNU General Public License as published by |
94653
e49abd957e81
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93844
diff
changeset
|
15 ;; the Free Software Foundation, either version 3 of the License, or |
e49abd957e81
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93844
diff
changeset
|
16 ;; (at your option) any later version. |
13053 | 17 |
18 ;; GNU Emacs is distributed in the hope that it will be useful, | |
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
21 ;; GNU General Public License for more details. | |
22 | |
23 ;; You should have received a copy of the GNU General Public License | |
94653
e49abd957e81
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93844
diff
changeset
|
24 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
13053 | 25 |
26 ;;; Commentary: | |
27 | |
93481
b3e69c64ac95
(Commentary): Point to calendar.el.
Glenn Morris <rgm@gnu.org>
parents:
93185
diff
changeset
|
28 ;; See calendar.el. |
20462
d179de7ad92e
Add reference to new Calendrical Calculations book.
Paul Eggert <eggert@twinsun.com>
parents:
14169
diff
changeset
|
29 |
13053 | 30 ;;; Code: |
31 | |
32 (require 'calendar) | |
33 | |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
34 (defun calendar-iso-to-absolute (date) |
13053 | 35 "The number of days elapsed between the Gregorian date 12/31/1 BC and DATE. |
36 The `ISO year' corresponds approximately to the Gregorian year, but | |
37 weeks start on Monday and end on Sunday. The first week of the ISO year is | |
38 the first such week in which at least 4 days are in a year. The ISO | |
39 commercial DATE has the form (week day year) in which week is in the range | |
40 1..52 and day is in the range 0..6 (1 = Monday, 2 = Tuesday, ..., 0 = | |
41 Sunday). The Gregorian date Sunday, December 31, 1 BC is imaginary." | |
93809
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
42 (let ((day (calendar-extract-day date))) |
13053 | 43 (+ (calendar-dayname-on-or-before |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
44 1 (+ 3 (calendar-absolute-from-gregorian |
93809
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
45 (list 1 1 (calendar-extract-year date))))) |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
46 ;; ISO date is (week day year); normally (month day year). |
93809
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
47 (* 7 (1- (calendar-extract-month date))) |
92586
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
48 (if (zerop day) 6 (1- day))))) |
13053 | 49 |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
50 (define-obsolete-function-alias 'calendar-absolute-from-iso |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
51 'calendar-iso-to-absolute "23.1") |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
52 |
96298
c3ebac47d0e9
(calendar-iso-from-absolute): Add autoload cookie.
Glenn Morris <rgm@gnu.org>
parents:
94653
diff
changeset
|
53 ;;;###cal-autoload |
13053 | 54 (defun calendar-iso-from-absolute (date) |
55 "Compute the `ISO commercial date' corresponding to the absolute DATE. | |
56 The ISO year corresponds approximately to the Gregorian year, but weeks | |
57 start on Monday and end on Sunday. The first week of the ISO year is the | |
58 first such week in which at least 4 days are in a year. The ISO commercial | |
59 date has the form (week day year) in which week is in the range 1..52 and | |
60 day is in the range 0..6 (1 = Monday, 2 = Tuesday, ..., 0 = Sunday). The | |
61 absolute date is the number of days elapsed since the (imaginary) Gregorian | |
62 date Sunday, December 31, 1 BC." | |
93809
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
63 (let* ((approx (calendar-extract-year |
13053 | 64 (calendar-gregorian-from-absolute (- date 3)))) |
65 (year (+ approx | |
66 (calendar-sum y approx | |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
67 (>= date (calendar-iso-to-absolute |
92902 | 68 (list 1 1 (1+ y)))) |
69 1)))) | |
13053 | 70 (list |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
71 (1+ (/ (- date (calendar-iso-to-absolute (list 1 1 year))) 7)) |
13053 | 72 (% date 7) |
73 year))) | |
74 | |
92833
272f566348a7
(generated-autoload-file): Don't set, instead use different values of
Glenn Morris <rgm@gnu.org>
parents:
92818
diff
changeset
|
75 ;;;###cal-autoload |
13053 | 76 (defun calendar-iso-date-string (&optional date) |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
77 "String of ISO date of Gregorian DATE, default today." |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
38422
diff
changeset
|
78 (let* ((d (calendar-absolute-from-gregorian |
13053 | 79 (or date (calendar-current-date)))) |
80 (day (% d 7)) | |
81 (iso-date (calendar-iso-from-absolute d))) | |
82 (format "Day %s of week %d of %d" | |
83 (if (zerop day) 7 day) | |
93809
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
84 (calendar-extract-month iso-date) |
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
85 (calendar-extract-year iso-date)))) |
13053 | 86 |
92833
272f566348a7
(generated-autoload-file): Don't set, instead use different values of
Glenn Morris <rgm@gnu.org>
parents:
92818
diff
changeset
|
87 ;;;###cal-autoload |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
88 (defun calendar-iso-print-date () |
13053 | 89 "Show equivalent ISO date for the date under the cursor." |
90 (interactive) | |
91 (message "ISO date: %s" | |
92 (calendar-iso-date-string (calendar-cursor-to-date t)))) | |
93 | |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
94 (define-obsolete-function-alias 'calendar-print-iso-date |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
95 'calendar-iso-print-date "23.1") |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
96 |
93185
5a7437fafea3
(calendar-iso-read-date): New name for calendar-iso-read-args. Update
Glenn Morris <rgm@gnu.org>
parents:
92902
diff
changeset
|
97 (defun calendar-iso-read-date (&optional dayflag) |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
98 "Interactively read the arguments for an ISO date command. |
92625
e26350e23411
(calendar-iso-read-args): Doc fix.
Glenn Morris <rgm@gnu.org>
parents:
92609
diff
changeset
|
99 Reads a year and week, and if DAYFLAG is non-nil a day (otherwise |
e26350e23411
(calendar-iso-read-args): Doc fix.
Glenn Morris <rgm@gnu.org>
parents:
92609
diff
changeset
|
100 taken to be 1)." |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
101 (let* ((year (calendar-read |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
102 "ISO calendar year (>0): " |
92586
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
103 (lambda (x) (> x 0)) |
93844
bf9ef749c23e
Replace int-to-string with number-to-string.
Glenn Morris <rgm@gnu.org>
parents:
93809
diff
changeset
|
104 (number-to-string (calendar-extract-year |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
105 (calendar-current-date))))) |
93809
3ff2b47de8f2
Update for calendar.el name changes.
Glenn Morris <rgm@gnu.org>
parents:
93782
diff
changeset
|
106 (no-weeks (calendar-extract-month |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
107 (calendar-iso-from-absolute |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
108 (1- |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
109 (calendar-dayname-on-or-before |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
110 1 (calendar-absolute-from-gregorian |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
111 (list 1 4 (1+ year)))))))) |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
112 (week (calendar-read |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
113 (format "ISO calendar week (1-%d): " no-weeks) |
92586
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
114 (lambda (x) (and (> x 0) (<= x no-weeks))))) |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
115 (day (if dayflag (calendar-read |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
116 "ISO day (1-7): " |
92586
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
117 (lambda (x) (and (<= 1 x) (<= x 7)))) |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
118 1))) |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
119 (list (list week day year)))) |
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
120 |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
121 (define-obsolete-function-alias 'calendar-iso-read-args |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
122 'calendar-iso-read-date "23.1") |
93185
5a7437fafea3
(calendar-iso-read-date): New name for calendar-iso-read-args. Update
Glenn Morris <rgm@gnu.org>
parents:
92902
diff
changeset
|
123 |
92833
272f566348a7
(generated-autoload-file): Don't set, instead use different values of
Glenn Morris <rgm@gnu.org>
parents:
92818
diff
changeset
|
124 ;;;###cal-autoload |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
125 (defun calendar-iso-goto-date (date &optional noecho) |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
126 "Move cursor to ISO DATE; echo ISO date unless NOECHO is non-nil." |
93185
5a7437fafea3
(calendar-iso-read-date): New name for calendar-iso-read-args. Update
Glenn Morris <rgm@gnu.org>
parents:
92902
diff
changeset
|
127 (interactive (calendar-iso-read-date t)) |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
128 (calendar-goto-date (calendar-gregorian-from-absolute |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
129 (calendar-iso-to-absolute date))) |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
130 (or noecho (calendar-iso-print-date))) |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
131 |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
132 (define-obsolete-function-alias 'calendar-goto-iso-date |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
133 'calendar-iso-goto-date "23.1") |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
134 |
92833
272f566348a7
(generated-autoload-file): Don't set, instead use different values of
Glenn Morris <rgm@gnu.org>
parents:
92818
diff
changeset
|
135 ;;;###cal-autoload |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
136 (defun calendar-iso-goto-week (date &optional noecho) |
92818
3ed51c637a80
(calendar-absolute-from-iso, calendar-iso-read-args): Simplify.
Glenn Morris <rgm@gnu.org>
parents:
92625
diff
changeset
|
137 "Move cursor to ISO DATE; echo ISO date unless NOECHO is non-nil. |
57324
f51c087984a0
Update copyright and maintainer.
Glenn Morris <rgm@gnu.org>
parents:
52401
diff
changeset
|
138 Interactively, goes to the first day of the specified week." |
93185
5a7437fafea3
(calendar-iso-read-date): New name for calendar-iso-read-args. Update
Glenn Morris <rgm@gnu.org>
parents:
92902
diff
changeset
|
139 (interactive (calendar-iso-read-date)) |
13053 | 140 (calendar-goto-date (calendar-gregorian-from-absolute |
93643
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
141 (calendar-iso-to-absolute date))) |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
142 (or noecho (calendar-iso-print-date))) |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
143 |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
144 (define-obsolete-function-alias 'calendar-goto-iso-week |
e6a9bdb70ed7
(calendar-iso-to-absolute): Rename calendar-absolute-from-iso.
Glenn Morris <rgm@gnu.org>
parents:
93481
diff
changeset
|
145 'calendar-iso-goto-week "23.1") |
13053 | 146 |
92586
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
147 (defvar date) |
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
148 |
93782 | 149 ;; To be called from diary-list-sexp-entries, where DATE is bound. |
92833
272f566348a7
(generated-autoload-file): Don't set, instead use different values of
Glenn Morris <rgm@gnu.org>
parents:
92818
diff
changeset
|
150 ;;;###diary-autoload |
13053 | 151 (defun diary-iso-date () |
152 "ISO calendar equivalent of date diary entry." | |
153 (format "ISO date: %s" (calendar-iso-date-string date))) | |
154 | |
155 (provide 'cal-iso) | |
156 | |
92586
15aa69393e42
Unquote lambda functions. Add autoload cookies to functions formerly
Glenn Morris <rgm@gnu.org>
parents:
79703
diff
changeset
|
157 ;; arch-tag: 3c0154cc-d30f-4981-9f60-42bdf7a468f6 |
13053 | 158 ;;; cal-iso.el ends here |