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-datesOfficial Naw-Rúz dates from the Bahá’í World Centre (2015-2064).
calendar-bahai--twin-birthdays-reference-datesOfficial Twin Holy Birthday dates from the Bahá’í World Centre (2015-2064).
calendar-bahai-epochAbsolute date of start of Bahá’í calendar = March 21, 1844 AD.
calendar-bahai-leap-baseNumber of leap years between 1 and 1844 AD, inclusive.
calendar-bahai-month-name-arrayArray of the month names in the Bahá’í calendar.
calendar-bahai-reform-yearBahá’í year when calendar reform took effect.
calendar-bahai-tehran-latitudeLatitude of Tehran, Iran in decimal degrees.
calendar-bahai-tehran-longitudeLongitude of Tehran, Iran in decimal degrees.
calendar-bahai-tehran-timezoneTehran 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()

Defined faces (0)