;;; cal-persia.el --- calendar functions for the Persian calendar
-;; Copyright (C) 1996, 1997, 2001, 2002, 2003, 2004, 2005, 2006, 2007
-;; Free Software Foundation, Inc.
+;; Copyright (C) 1996, 1997, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
+;; 2008, 2009, 2010 Free Software Foundation, Inc.
;; Author: Edward M. Reingold <reingold@cs.uiuc.edu>
;; Maintainer: Glenn Morris <rgm@gnu.org>
;; This file is part of GNU Emacs.
-;; GNU Emacs is free software; you can redistribute it and/or modify
+;; 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
-;; the Free Software Foundation; either version 2, or (at your option)
-;; any later version.
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) 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
;; 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
-;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
-;; Boston, MA 02110-1301, USA.
+;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
-;; This collection of functions implements the features of calendar.el and
-;; diary.el that deal with the Persian calendar.
+;; See calendar.el.
;;; Code:
-(defvar date)
-
-(require 'cal-julian)
+(require 'calendar)
-(defvar persian-calendar-month-name-array
+(defconst calendar-persian-month-name-array
["Farvardin" "Ordibehest" "Xordad" "Tir" "Mordad" "Sahrivar" "Mehr" "Aban"
- "Azar" "Dey" "Bahman" "Esfand"])
+ "Azar" "Dey" "Bahman" "Esfand"]
+ "Names of the months in the Persian calendar.")
-(defvar persian-calendar-epoch (calendar-absolute-from-julian '(3 19 622))
- "Absolute date of start of Persian calendar = March 19, 622 A.D. (Julian).")
+(eval-and-compile
+ (autoload 'calendar-julian-to-absolute "cal-julian"))
-(defun persian-calendar-leap-year-p (year)
+(defconst calendar-persian-epoch
+ (eval-when-compile (calendar-julian-to-absolute '(3 19 622)))
+ "Absolute date of start of Persian calendar = March 19, 622 AD (Julian).")
+
+(defun calendar-persian-leap-year-p (year)
"True if YEAR is a leap year on the Persian calendar."
(< (mod (* (mod (mod (if (<= 0 year)
- ; No year zero
- (+ year 2346)
+ (+ year 2346) ; no year zero
(+ year 2347))
2820)
768)
- 683)
- 2820)
- 683))
+ 683)
+ 2820)
+ 683))
-(defun persian-calendar-last-day-of-month (month year)
+(defun calendar-persian-last-day-of-month (month year)
"Return last day of MONTH, YEAR on the Persian calendar."
(cond
((< month 7) 31)
- ((or (< month 12) (persian-calendar-leap-year-p year)) 30)
+ ((or (< month 12) (calendar-persian-leap-year-p year)) 30)
(t 29)))
-(defun calendar-absolute-from-persian (date)
+(defun calendar-persian-to-absolute (date)
"Compute absolute date from Persian date DATE.
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))
- (day (extract-calendar-day date))
- (year (extract-calendar-year date)))
+ (let ((month (calendar-extract-month date))
+ (day (calendar-extract-day date))
+ (year (calendar-extract-year date)))
(if (< year 0)
- (+ (calendar-absolute-from-persian
+ (+ (calendar-persian-to-absolute
(list month day (1+ (mod year 2820))))
(* 1029983 (floor year 2820)))
- (+ (1- persian-calendar-epoch); Days before epoch
- (* 365 (1- year)) ; Days in prior years.
- (* 683 ; Leap days in prior 2820-year cycles
+ (+ (1- calendar-persian-epoch) ; days before epoch
+ (* 365 (1- year)) ; days in prior years
+ (* 683 ; leap days in prior 2820-year cycles
(floor (+ year 2345) 2820))
- (* 186 ; Leap days in prior 768 year cycles
+ (* 186 ; leap days in prior 768 year cycles
(floor (mod (+ year 2345) 2820) 768))
- (floor; Leap years in current 768 or 516 year cycle
+ (floor ; leap years in current 768 or 516 year cycle
(* 683 (mod (mod (+ year 2345) 2820) 768))
2820)
- -568 ; Leap years in Persian years -2345...-1
- (calendar-sum ; Days in prior months this year.
+ -568 ; leap years in Persian years -2345...-1
+ (calendar-sum ; days in prior months this year
m 1 (< m month)
- (persian-calendar-last-day-of-month m year))
- day)))) ; Days so far this month.
+ (calendar-persian-last-day-of-month m year))
+ day)))) ; days so far this month
+
+(define-obsolete-function-alias 'calendar-absolute-from-persian
+ 'calendar-persian-to-absolute "23.1")
(defun calendar-persian-year-from-absolute (date)
"Persian year corresponding to the absolute DATE."
- (let* ((d0 ; Prior days since start of 2820 cycles
- (- date (calendar-absolute-from-persian (list 1 1 -2345))))
- (n2820 ; Completed 2820-year cycles
+ (let* ((d0 ; prior days since start of 2820 cycles
+ (- date (calendar-persian-to-absolute (list 1 1 -2345))))
+ (n2820 ; completed 2820-year cycles
(floor d0 1029983))
- (d1 ; Prior days not in n2820
+ (d1 ; prior days not in n2820
(mod d0 1029983))
- (n768 ; 768-year cycles not in n2820
+ (n768 ; 768-year cycles not in n2820
(floor d1 280506))
- (d2 ; Prior days not in n2820 or n768
+ (d2 ; prior days not in n2820 or n768
(mod d1 280506))
- (n1 ; Years not in n2820 or n768
- ; we want is
- ; (floor (+ (* 2820 d2) (* 2820 366)) 1029983))
- ; but that causes overflow, so we use
- (let ((a (floor d2 366)); we use 366 as the divisor because
- ; (2820*366 mod 1029983) is small
+ (n1 ; years not in n2820 or n768
+ ;; Want:
+ ;; (floor (+ (* 2820 d2) (* 2820 366)) 1029983))
+ ;; but that causes overflow, so use the following.
+ ;; Use 366 as the divisor because (2820*366 mod 1029983) is small.
+ (let ((a (floor d2 366))
(b (mod d2 366)))
(+ 1 a (floor (+ (* 2137 a) (* 2820 b) 2137) 1029983))))
- (year (+ (* 2820 n2820); Complete 2820 year cycles
- (* 768 n768) ; Complete 768 year cycles
- (if ; Remaining years
- ; Last day of 2820 year cycle
- (= d1 1029617)
+ (year (+ (* 2820 n2820) ; complete 2820 year cycles
+ (* 768 n768) ; complete 768 year cycles
+ ;; Remaining years.
+ (if (= d1 1029617) ; last day of 2820 year cycle
(1- n1)
n1)
- -2345))) ; Years before year 1
+ -2345))) ; years before year 1
(if (< year 1)
- (1- year); No year zero
+ (1- year) ; no year zero
year)))
(defun calendar-persian-from-absolute (date)
The absolute date is the number of days elapsed since the imaginary
Gregorian date Sunday, December 31, 1 BC."
(let* ((year (calendar-persian-year-from-absolute date))
- (month ; Search forward from Farvardin
+ (month ; search forward from Farvardin
(1+ (calendar-sum m 1
(> date
- (calendar-absolute-from-persian
+ (calendar-persian-to-absolute
(list
m
- (persian-calendar-last-day-of-month m year)
+ (calendar-persian-last-day-of-month m year)
year)))
1)))
- (day ; Calculate the day by subtraction
- (- date (1- (calendar-absolute-from-persian
+ (day ; calculate the day by subtraction
+ (- date (1- (calendar-persian-to-absolute
(list month 1 year))))))
(list month day year)))
+;;;###cal-autoload
(defun calendar-persian-date-string (&optional date)
- "String of Persian date of Gregorian DATE.
-Defaults to today's date if DATE is not given."
+ "String of Persian date of Gregorian DATE, default today."
(let* ((persian-date (calendar-persian-from-absolute
- (calendar-absolute-from-gregorian
- (or date (calendar-current-date)))))
- (y (extract-calendar-year persian-date))
- (m (extract-calendar-month persian-date)))
- (let ((monthname (aref persian-calendar-month-name-array (1- m)))
- (day (int-to-string (extract-calendar-day persian-date)))
- (dayname nil)
- (month (int-to-string m))
- (year (int-to-string y)))
- (mapconcat 'eval calendar-date-display-form ""))))
-
-(defun calendar-print-persian-date ()
+ (calendar-absolute-from-gregorian
+ (or date (calendar-current-date)))))
+ (y (calendar-extract-year persian-date))
+ (m (calendar-extract-month persian-date))
+ (monthname (aref calendar-persian-month-name-array (1- m)))
+ (day (number-to-string (calendar-extract-day persian-date)))
+ (year (number-to-string y))
+ (month (number-to-string m))
+ dayname)
+ (mapconcat 'eval calendar-date-display-form "")))
+
+;;;###cal-autoload
+(defun calendar-persian-print-date ()
"Show the Persian calendar equivalent of the selected date."
(interactive)
(message "Persian date: %s"
(calendar-persian-date-string (calendar-cursor-to-date t))))
-(defun calendar-goto-persian-date (date &optional noecho)
- "Move cursor to Persian date DATE.
-Echo Persian date unless NOECHO is t."
- (interactive (persian-prompt-for-date))
- (calendar-goto-date (calendar-gregorian-from-absolute
- (calendar-absolute-from-persian date)))
- (or noecho (calendar-print-persian-date)))
+(define-obsolete-function-alias 'calendar-print-persian-date
+ 'calendar-persian-print-date "23.1")
-(defun persian-prompt-for-date ()
- "Ask for a Persian date."
- (let* ((today (calendar-current-date))
- (year (calendar-read
+(defun calendar-persian-read-date ()
+ "Interactively read the arguments for a Persian date command.
+Reads a year, month, and day."
+ (let* ((year (calendar-read
"Persian calendar year (not 0): "
- '(lambda (x) (/= x 0))
- (int-to-string
- (extract-calendar-year
+ (lambda (x) (not (zerop x)))
+ (number-to-string
+ (calendar-extract-year
(calendar-persian-from-absolute
- (calendar-absolute-from-gregorian today))))))
+ (calendar-absolute-from-gregorian
+ (calendar-current-date)))))))
(completion-ignore-case t)
(month (cdr (assoc
- (completing-read
- "Persian calendar month name: "
- (mapcar 'list
- (append persian-calendar-month-name-array nil))
- nil t)
- (calendar-make-alist persian-calendar-month-name-array
+ (completing-read
+ "Persian calendar month name: "
+ (mapcar 'list
+ (append calendar-persian-month-name-array nil))
+ nil t)
+ (calendar-make-alist calendar-persian-month-name-array
1))))
- (last (persian-calendar-last-day-of-month month year))
+ (last (calendar-persian-last-day-of-month month year))
(day (calendar-read
(format "Persian calendar day (1-%d): " last)
- '(lambda (x) (and (< 0 x) (<= x last))))))
+ (lambda (x) (and (< 0 x) (<= x last))))))
(list (list month day year))))
+(define-obsolete-function-alias 'persian-prompt-for-date
+ 'calendar-persian-read-date "23.1")
+
+;;;###cal-autoload
+(defun calendar-persian-goto-date (date &optional noecho)
+ "Move cursor to Persian date DATE.
+Echo Persian date unless NOECHO is non-nil."
+ (interactive (calendar-persian-read-date))
+ (calendar-goto-date (calendar-gregorian-from-absolute
+ (calendar-persian-to-absolute date)))
+ (or noecho (calendar-persian-print-date)))
+
+(define-obsolete-function-alias 'calendar-goto-persian-date
+ 'calendar-persian-goto-date "23.1")
+
+(defvar date)
+
+;; To be called from diary-list-sexp-entries, where DATE is bound.
+;;;###diary-autoload
(defun diary-persian-date ()
"Persian calendar equivalent of date diary entry."
(format "Persian date: %s" (calendar-persian-date-string date)))
(provide 'cal-persia)
-;;; arch-tag: 2832383c-e4b4-4dc2-8ee9-cfbdd53e5e2d
+;; arch-tag: 2832383c-e4b4-4dc2-8ee9-cfbdd53e5e2d
;;; cal-persia.el ends here