File: cal-bahai.el.html
This collection of functions implements the features of calendar.el and diary-lib.el that deal with the Bahá’í calendar.
The Bahá’í (https://www.bahai.org) calendar system is based on a
solar cycle of 19 months with 19 days each. The remaining
"intercalary" days are called the Ayyám-i-Há (days of Há), and are
placed between the 18th and 19th months. They are meant as a time
of festivals preceding the 19th month, which is the month of
fasting. (Há 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
Váhids. A cycle of 19 Váhids (361 years) is called a Kullu-Shay,
which means "all things".
The calendar was named the "Badí‘ calendar" by its author, the Báb. 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.
CALENDAR REFORM (2014/172 BE): Prior to 172 BE (before Naw-Rúz 2015 CE), Naw-Rúz was fixed at March 21 and leap years followed the Gregorian pattern.
From 172 BE onwards, the Universal House of Justice implemented
astronomical observations:
- Naw-Rúz is determined by the vernal equinox as observed from Tehran
- Naw-Rúz can fall on March 19, 20, 21, or 22
- Ayyám-i-Há has 4 or 5 days depending on the gap between successive
Naw-Rúz dates (ensuring month 19 always ends the day before Naw-Rúz)
- Days run from sunset to sunset; if the equinox occurs before sunset
in Tehran, that day is Naw-Rúz; otherwise the next day is Naw-Rúz
The implementation uses official tables from the Nautical Almanac Office for years 172-221 BE (2015-2064 CE), and astronomical calculations for years beyond this range.
Note: The days of Ayyám-i-Há are encoded as zero and negative offsets from the first day of the final month. So, (19 -3 157) is the first day of Ayyám-i-Há, in the year 157 BE.
Defined variables (9)
calendar-bahai--nawruz-reference-dates | Official Naw-Rúz dates from the Bahá’í World Centre (2015-2064). |
calendar-bahai--twin-birthdays-reference-dates | Official Twin Holy Birthday dates from the Bahá’í World Centre (2015-2064). |
calendar-bahai-epoch | Absolute date of start of Bahá’í calendar = March 21, 1844 AD. |
calendar-bahai-leap-base | Number of leap years between 1 and 1844 AD, inclusive. |
calendar-bahai-month-name-array | Array of the month names in the Bahá’í calendar. |
calendar-bahai-reform-year | Bahá’í year when calendar reform took effect. |
calendar-bahai-tehran-latitude | Latitude of Tehran, Iran in decimal degrees. |
calendar-bahai-tehran-longitude | Longitude of Tehran, Iran in decimal degrees. |
calendar-bahai-tehran-timezone | Tehran timezone offset in minutes (UTC+3:30 = 210 minutes). |
Defined functions (25)
calendar-bahai--verify-nawruz | () |
calendar-bahai--verify-twin-birthdays | () |
calendar-bahai-date-string | (&optional DATE) |
calendar-bahai-from-absolute | (DATE) |
calendar-bahai-goto-date | (DATE &optional NOECHO) |
calendar-bahai-leap-year-p | (YEAR) |
calendar-bahai-mark-date-pattern | (MONTH DAY YEAR &optional COLOR) |
calendar-bahai-nawruz | (YEAR) |
calendar-bahai-nawruz-for-gregorian-year | (GREG-YEAR) |
calendar-bahai-print-date | () |
calendar-bahai-read-date | () |
calendar-bahai-run-tests | () |
calendar-bahai-to-absolute | (DATE) |
calendar-bahai-twin-holy-birthdays-for-year | (BAHAI-YEAR) |
calendar-bahai-verify-calculations | () |
diary-bahai-date | () |
diary-bahai-insert-entry | (ARG) |
diary-bahai-insert-monthly-entry | (ARG) |
diary-bahai-insert-yearly-entry | (ARG) |
diary-bahai-list-entries | () |
diary-bahai-mark-entries | () |
holiday-bahai | (MONTH DAY STRING) |
holiday-bahai-new-year | () |
holiday-bahai-ridvan | (&optional ALL) |
holiday-bahai-twin-holy-birthdays | () |