cal-bahai.el 13.8 KB
Newer Older
1
;;; cal-bahai.el --- calendar functions for the Bahá'í calendar.
2

Glenn Morris's avatar
Glenn Morris committed
3
;; Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
Glenn Morris's avatar
Glenn Morris committed
4
;;   Free Software Foundation, Inc.
5 6 7

;; Author: John Wiegley <johnw@gnu.org>
;; Keywords: calendar
8
;; Human-Keywords: Bahá'í calendar, Bahá'í, Baha'i, Bahai, calendar, diary
9 10 11 12 13

;; This file is part of GNU Emacs.

;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
14
;; the Free Software Foundation; either version 3, or (at your option)
15 16 17 18 19 20 21 22 23
;; any later version.

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING.  If not, write to the
Lute Kamstra's avatar
Lute Kamstra committed
24 25
;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
;; Boston, MA 02110-1301, USA.
26 27 28 29

;;; Commentary:

;; This collection of functions implements the features of calendar.el
30
;; and diary.el that deal with the Bahá'í calendar.
31

32
;; The Bahá'í (http://www.bahai.org) calendar system is based on a
33
;; solar cycle of 19 months with 19 days each.  The four remaining
34
;; "intercalary" days are called the Ayyám-i-Há (days of Há), and are
35 36
;; placed between the 18th and 19th months.  They are meant as a time
;; of festivals preceding the 19th month, which is the month of
37
;; fasting.  In Gregorian leap years, there are 5 of these days (Há
38 39 40 41 42 43
;; has the numerical value of 5 in the arabic abjad, or
;; letter-to-number, reckoning).

;; Each month is named after an attribute of God, as are the 19 days
;; -- which have the same names as the months.  There is also a name
;; for each year in every 19 year cycle.  These cycles are called
44
;; Váhids.  A cycle of 19 Váhids (361 years) is called a Kullu-Shay,
45 46
;; which means "all things".

47
;; The calendar was named the "Badí` calendar" by its author, the Báb.
48 49 50 51
;; It uses a week of seven days, corresponding to the Gregorian week,
;; each of which has its own name, again patterned after the
;; attributes of God.

52
;; Note: The days of Ayyám-i-Há are encoded as zero and negative
53
;; offsets from the first day of the final month.  So, (19 -3 157) is
54
;; the first day of Ayyám-i-Há, in the year 157 BE.
55 56 57 58 59

;;; Code:

(require 'cal-julian)

60
(defconst calendar-bahai-month-name-array
61 62
  ["Bahá" "Jalál" "Jamál" "`Azamat" "Núr" "Rahmat" "Kalimát" "Kamál"
   "Asmá" "`Izzat" "Mashiyyat" "`Ilm" "Qudrat" "Qawl" "Masá'il"
63 64
   "Sharaf" "Sultán" "Mulk" "`Alá"]
  "Array of the month names in the Bahá'í calendar.")
65

66
(defconst calendar-bahai-epoch (calendar-absolute-from-gregorian '(3 21 1844))
67
  "Absolute date of start of Bahá'í calendar = March 19, 622 AD (Julian).")
68

69
(defun calendar-bahai-leap-year-p (year)
Glenn Morris's avatar
Glenn Morris committed
70
  "True if Bahá'í YEAR is a leap year in the Bahá'í calendar."
71 72
  (calendar-leap-year-p (+ year 1844)))

73
(defconst calendar-bahai-leap-base
74
  (+ (/ 1844 4) (- (/ 1844 100)) (/ 1844 400))
Glenn Morris's avatar
Glenn Morris committed
75 76
  "Number of leap years between 1 and 1844 AD, inclusive.
Used by `calendar-absolute-from-bahai'.")
77 78

(defun calendar-absolute-from-bahai (date)
79
  "Compute absolute date from Bahá'í date DATE.
80 81 82
The absolute date is the number of days elapsed since the (imaginary)
Gregorian date Sunday, December 31, 1 BC."
  (let* ((month (extract-calendar-month date))
Glenn Morris's avatar
Glenn Morris committed
83 84 85 86 87 88 89 90 91
         (day (extract-calendar-day date))
         (year (extract-calendar-year date))
         (prior-years (+ (1- year) 1844))
         (leap-days (- (+ (/ prior-years 4) ; leap days in prior years
                          (- (/ prior-years 100))
                          (/ prior-years 400))
                       calendar-bahai-leap-base)))
    (+ (1- calendar-bahai-epoch)        ; days before epoch
       (* 365 (1- year))                ; days in prior years
92 93
       leap-days
       (calendar-sum m 1 (< m month) 19)
Glenn Morris's avatar
Glenn Morris committed
94 95 96
       (if (= month 19)
           (if (calendar-bahai-leap-year-p year) 5 4)
         0)
Glenn Morris's avatar
Glenn Morris committed
97
       day)))                           ; days so far this month
98 99

(defun calendar-bahai-from-absolute (date)
Glenn Morris's avatar
Glenn Morris committed
100
  "Bahá'í date (month day year) corresponding to the absolute DATE."
101
  (if (< date calendar-bahai-epoch)
Glenn Morris's avatar
Glenn Morris committed
102
      (list 0 0 0)                      ; pre-Bahá'í date
103
    (let* ((greg (calendar-gregorian-from-absolute date))
Glenn Morris's avatar
Glenn Morris committed
104
           (gmonth (extract-calendar-month greg))
Glenn Morris's avatar
Glenn Morris committed
105
           (year (+ (- (extract-calendar-year greg) 1844)
Glenn Morris's avatar
Glenn Morris committed
106 107
                    (if (or (> gmonth 3)
                            (and (= gmonth 3)
Glenn Morris's avatar
Glenn Morris committed
108 109
                                 (>= (extract-calendar-day greg) 21)))
                        1 0)))
Glenn Morris's avatar
Glenn Morris committed
110
           (month                       ; search forward from Baha
111
            (1+ (calendar-sum m 1
Glenn Morris's avatar
Glenn Morris committed
112
                  (> date (calendar-absolute-from-bahai (list m 19 year)))
Glenn Morris's avatar
Glenn Morris committed
113
                  1)))
Glenn Morris's avatar
Glenn Morris committed
114
           (day                     ; calculate the day by subtraction
115 116 117 118
            (- date
               (1- (calendar-absolute-from-bahai (list month 1 year))))))
      (list month day year))))

119
;;;###cal-autoload
120
(defun calendar-bahai-date-string (&optional date)
121
  "String of Bahá'í date of Gregorian DATE.
122 123
Defaults to today's date if DATE is not given."
  (let* ((bahai-date (calendar-bahai-from-absolute
Glenn Morris's avatar
Glenn Morris committed
124 125
                      (calendar-absolute-from-gregorian
                       (or date (calendar-current-date)))))
126 127
         (y (extract-calendar-year bahai-date))
         (m (extract-calendar-month bahai-date))
Glenn Morris's avatar
Glenn Morris committed
128 129 130 131 132 133 134
         (d (extract-calendar-day bahai-date))
         (monthname (if (and (= m 19)
                             (<= d 0))
                        "Ayyám-i-Há"
                      (aref calendar-bahai-month-name-array (1- m))))
         (day (int-to-string
               (if (<= d 0)
Glenn Morris's avatar
Glenn Morris committed
135
                   (+ d (if (calendar-bahai-leap-year-p y) 5 4))
Glenn Morris's avatar
Glenn Morris committed
136 137 138 139
                 d)))
         (year (int-to-string y))
         (month (int-to-string m))
         dayname)
Glenn Morris's avatar
Glenn Morris committed
140 141 142 143
    (if (< y 1)
        ""
      ;; Can't call calendar-date-string because of monthname oddity.
      (mapconcat 'eval calendar-date-display-form ""))))
144

145
;;;###cal-autoload
146
(defun calendar-bahai-print-date ()
147
  "Show the Bahá'í calendar equivalent of the selected date."
148
  (interactive)
Glenn Morris's avatar
Glenn Morris committed
149 150 151 152
  (let ((s (calendar-bahai-date-string (calendar-cursor-to-date t))))
   (if (string-equal s "")
       (message "Date is pre-Bahá'í")
     (message "Bahá'í date: %s" s))))
153

Glenn Morris's avatar
Glenn Morris committed
154 155 156
(define-obsolete-function-alias
  'calendar-print-bahai-date 'calendar-bahai-print-date "23.1")

157
(defun calendar-bahai-prompt-for-date ()
158
  "Ask for a Bahá'í date."
159 160
  (let* ((today (calendar-current-date))
         (year (calendar-read
161
                "Bahá'í calendar year (not 0): "
162
                (lambda (x) (not (zerop x)))
163 164 165 166 167 168
                (int-to-string
                 (extract-calendar-year
                  (calendar-bahai-from-absolute
                   (calendar-absolute-from-gregorian today))))))
         (completion-ignore-case t)
         (month (cdr (assoc
Glenn Morris's avatar
Glenn Morris committed
169 170 171 172 173
                      (completing-read
                       "Bahá'í calendar month name: "
                       (mapcar 'list
                               (append calendar-bahai-month-name-array nil))
                       nil t)
174
                      (calendar-make-alist calendar-bahai-month-name-array
175
                                           1))))
176
         (day (calendar-read "Bahá'í calendar day (1-19): "
Glenn Morris's avatar
Glenn Morris committed
177
                             (lambda (x) (and (< 0 x) (<= x 19))))))
178 179
    (list (list month day year))))

180 181
;;;###cal-autoload
(defun calendar-bahai-goto-date (date &optional noecho)
Glenn Morris's avatar
Glenn Morris committed
182
  "Move cursor to Bahá'í date DATE; echo Bahá'í date unless NOECHO is non-nil."
183 184 185 186 187
  (interactive (calendar-bahai-prompt-for-date))
  (calendar-goto-date (calendar-gregorian-from-absolute
                       (calendar-absolute-from-bahai date)))
  (or noecho (calendar-bahai-print-date)))

Glenn Morris's avatar
Glenn Morris committed
188 189 190
(define-obsolete-function-alias
  'calendar-goto-bahai-date 'calendar-bahai-goto-date "23.1")

191 192
(defvar displayed-month)
(defvar displayed-year)
193

194
;;;###holiday-autoload
195
(defun holiday-bahai (month day string)
196 197
  "Holiday on MONTH, DAY (Bahá'í) called STRING.
If MONTH, DAY (Bahá'í) is visible, the value returned is corresponding
198 199 200
Gregorian date in the form of the list (((month day year) STRING)).  Returns
nil if it is not visible in the current calendar window."
  (let* ((bahai-date (calendar-bahai-from-absolute
Glenn Morris's avatar
Glenn Morris committed
201 202
                      (calendar-absolute-from-gregorian
                       (list displayed-month 15 displayed-year))))
203 204
         (m (extract-calendar-month bahai-date))
         (y (extract-calendar-year bahai-date))
Glenn Morris's avatar
Glenn Morris committed
205
         (date))
206
    (unless (< m 1)                    ; Bahá'í calendar doesn't apply
207
      (increment-calendar-month m y (- 10 month))
Glenn Morris's avatar
Glenn Morris committed
208
      (if (> m 7)                       ; Bahá'í date might be visible
209 210 211 212 213
          (let ((date (calendar-gregorian-from-absolute
                       (calendar-absolute-from-bahai (list month day y)))))
            (if (calendar-date-is-visible-p date)
                (list (list date string))))))))

214
(autoload 'diary-list-entries-1 "diary-lib")
215

216
;; FIXME diary-bahai-mark-entries said the names could be spelled in full.
217
;;;###diary-autoload
218
(defun diary-bahai-list-entries ()
219
  "Add any Bahá'í date entries from the diary file to `diary-entries-list'.
220 221 222 223 224 225 226
Bahá'í date diary entries must be prefaced by `bahai-diary-entry-symbol'
\(normally a `B').  The same diary date forms govern the style of the
Bahá'í calendar entries, except that the Bahá'í month names must be given
numerically.  The Bahá'í months are numbered from 1 to 19 with Bahá being
1 and 19 being `Alá.  If a Bahá'í date diary entry begins with
`diary-nonmarking-symbol', the entry will appear in the diary listing, but
will not be marked in the calendar.  This function is provided for use with
227
`nongregorian-diary-listing-hook'."
Glenn Morris's avatar
Glenn Morris committed
228 229 230 231 232 233 234 235
  (diary-list-entries-1 calendar-bahai-month-name-array
                        bahai-diary-entry-symbol
                        'calendar-bahai-from-absolute))
(define-obsolete-function-alias
  'list-bahai-diary-entries 'diary-bahai-list-entries "23.1")


(autoload 'calendar-mark-1 "diary-lib")
236

237
;;;###diary-autoload
Glenn Morris's avatar
Glenn Morris committed
238
(defun calendar-bahai-mark-date-pattern (month day year &optional color)
239
  "Mark dates in calendar window that conform to Bahá'í date MONTH/DAY/YEAR.
Glenn Morris's avatar
Glenn Morris committed
240 241 242 243 244 245 246 247
A value of 0 in any position is a wildcard.  Optional argument COLOR is
passed to `mark-visible-calendar-date' as MARK."
  (calendar-mark-1 month day year 'calendar-bahai-from-absolute
                   'calendar-absolute-from-bahai color))

(define-obsolete-function-alias
  'mark-bahai-calendar-date-pattern 'calendar-bahai-mark-date-pattern "23.1")

248

249
(autoload 'diary-mark-entries-1 "diary-lib")
250

251
;;;###diary-autoload
252
(defun diary-bahai-mark-entries ()
253
  "Mark days in the calendar window that have Bahá'í date diary entries.
254 255 256 257 258 259
Marks each entry in `diary-file' (or included files) visible in the calendar
window.  See `diary-bahai-list-entries' for more information."
  (diary-mark-entries-1 calendar-bahai-month-name-array
                        bahai-diary-entry-symbol
                        'calendar-bahai-from-absolute
                        'calendar-bahai-mark-date-pattern))
260

Glenn Morris's avatar
Glenn Morris committed
261 262 263
(define-obsolete-function-alias
  'mark-bahai-diary-entries 'diary-bahai-mark-entries "23.1")

264
;;;###cal-autoload
265
(defun diary-bahai-insert-entry (arg)
266
  "Insert a diary entry.
267
For the Bahá'í date corresponding to the date indicated by point.
Glenn Morris's avatar
Glenn Morris committed
268
Prefix argument ARG makes the entry nonmarking."
269
  (interactive "P")
Glenn Morris's avatar
Glenn Morris committed
270
  (let ((calendar-month-name-array calendar-bahai-month-name-array))
271
    (make-diary-entry
272 273 274 275 276
     (concat bahai-diary-entry-symbol
             (calendar-date-string
              (calendar-bahai-from-absolute
               (calendar-absolute-from-gregorian (calendar-cursor-to-date t)))
              nil t))
277 278
     arg)))

Glenn Morris's avatar
Glenn Morris committed
279 280 281
(define-obsolete-function-alias
  'insert-bahai-diary-entry 'diary-bahai-insert-entry "23.1")

282
;;;###cal-autoload
283
(defun diary-bahai-insert-monthly-entry (arg)
284
  "Insert a monthly diary entry.
285
For the day of the Bahá'í month corresponding to the date indicated by point.
Glenn Morris's avatar
Glenn Morris committed
286
Prefix argument ARG makes the entry nonmarking."
287
  (interactive "P")
Glenn Morris's avatar
Glenn Morris committed
288 289 290 291
  (let ((calendar-date-display-form (if european-calendar-style
                                        '(day " * ")
                                      '("* " day )))
        (calendar-month-name-array calendar-bahai-month-name-array))
292
    (make-diary-entry
293 294 295 296
     (concat bahai-diary-entry-symbol
             (calendar-date-string
              (calendar-bahai-from-absolute
               (calendar-absolute-from-gregorian (calendar-cursor-to-date t)))))
297 298
     arg)))

Glenn Morris's avatar
Glenn Morris committed
299 300 301
(define-obsolete-function-alias
  'insert-monthly-bahai-diary-entry 'diary-bahai-insert-monthly-entry "23.1")

302
;;;###cal-autoload
303
(defun diary-bahai-insert-yearly-entry (arg)
304
  "Insert an annual diary entry.
305
For the day of the Bahá'í year corresponding to the date indicated by point.
Glenn Morris's avatar
Glenn Morris committed
306
Prefix argument ARG will make the entry nonmarking."
307
  (interactive "P")
Glenn Morris's avatar
Glenn Morris committed
308 309 310 311
  (let ((calendar-date-display-form (if european-calendar-style
                                        '(day " " monthname)
                                      '(monthname " " day)))
        (calendar-month-name-array calendar-bahai-month-name-array))
312
    (make-diary-entry
313 314 315 316
     (concat bahai-diary-entry-symbol
             (calendar-date-string
              (calendar-bahai-from-absolute
               (calendar-absolute-from-gregorian (calendar-cursor-to-date t)))))
317 318
     arg)))

Glenn Morris's avatar
Glenn Morris committed
319 320 321
(define-obsolete-function-alias
  'insert-yearly-bahai-diary-entry 'diary-bahai-insert-yearly-entry "23.1")

322 323 324 325 326 327 328 329 330
(defvar date)

;; To be called from list-sexp-diary-entries, where DATE is bound.
;;;###diary-autoload
(defun diary-bahai-date ()
  "Bahá'í calendar equivalent of date diary entry."
  (format "Bahá'í date: %s" (calendar-bahai-date-string date)))


331 332
(provide 'cal-bahai)

333 334 335 336
;; Local Variables:
;; coding: utf-8
;; End:

337
;; arch-tag: c1cb1d67-862a-4264-a01c-41cb4df01f14
338
;;; cal-bahai.el ends here