Provided by: jcal_0.4.1-2build1_amd64 bug

NAME

     jcal β€” displays a calendar

SYNOPSIS

     jcal [-epPVjy13] [[month] year]

DESCRIPTION

     jcal displays a simple calendar.  If arguments are not specified, the current month is displayed.  The
     options are as follows:

     -1      Display single month output.  (This is the default.)

     -3      Display prev/current/next month output.

     -j      Display Julian dates (days one-based, numbered from Farvardin 1).

     -p      Display Farsi numbers and names.

     -P      Display year based on Pahlavi epoch.

     -e      Display english names for weekdays.

     -y      Display a calendar for the current year.

     -V      Display calendar version.

     A single parameter specifies the year (1 - 9999) to be displayed; note the year must be fully specified:
     β€œcal 90” will not display a calendar for 1390.  Two parameters denote the month (1 - 12) and year.  If no
     parameters are specified, the current month's calendar is displayed.

     A year starts on Far 1.

BRIEF EXPLANATION

     True solar year, also known as tropical year, was a still later discovery.  One has to take equinox or
     solstice into account to keep an accurate track of the solar year.  The equinoxes are the two intersections
     of the sun's apparent annual path with the celestial equator. The sun reaches the vernal equinox on 1st of
     Farvardin, on or about 21st March, the summer solstice on 1st of Tir, on about 22nd June, the autumnal
     equinox on 1st Mehr, on or about 23rd September, and the winter solstice on 1st of Dey, on or about 22
     December. Because the two planes, the path of the sun and the celestial equator move in opposite
     directions, the equinoxes and solstices do not occur at the same points every year. This anti-clock
     movement of the intersection point is called precession. It moves one degree in 72 years, one Zodiac sign
     of 30 degrees in 2,156 years and one circle in 25,868 years. For further information on calendar, solar or
     tropical year, precession, and other astronomical data, refer to any good encyclopedia or a publication on
     astronomy and astrology.  The tropical year, based on the four seasons, is precise. It is 365.24224 solar
     days (365 days 5 hr 48 min 45.5 sec), and the tropical lunar year is 354.36708 solar days, a difference of
     10.87516 solar days.  We need not go far to find a workable calendar. Of all the present calendars, the
     official Iranian calendar, based on the astronomical system, is the most scientific calendar in use and
     bears the names of what are known as Zoroastrian months. It rightly has the vernal equinox (on or about
     21st March) at the beginning of the spring and the year. The fourth month begins on the summer solstice (on
     or about 22 June), the seventh month on the autumnal equinox (on or about 23 September), and the ninth
     month on the winter solstice (on or about 22 December).  In the true seasonal year, the first half contains
     186 days and the second half about 179.242 days. This means that the first six months are of 31 days each,
     the following five months of 30 days each, and the last month of 29 days, but which automatically becomes
     of 30 days in the so-called "leap" year. The four seasons begin on the first days of the seasonal quarters.
     This is exactly what the Iranian calendar follows: The first six months are of 31 days each, the next five
     months of 30 days each and the last month is of 29 days but of 30 days in the leap year. Reports indicate
     that the Central Asian republics may follow suit.  Historical evidence that the five Gatha days were added
     at the end of summer proves that the early "Zoroastrian" calendar had this fact in view.

THE INDO-IRANIAN CALENDAR

     Evidences from the Avesta and the Vedas show that the Indo-Iranians, like many other people, followed a
     lunisolar year for their animal husbandry and agricultural purpose.  The names of the six Gaahaanbaars, six
     parts of the Vedic year and the Achaemenian months, as seen below, show that the calendar was based on
     various seasonal phases of the year.  The Gathas speak of the paths of the sun and the stars, and speaks
     about the waxing and waning phases of the moon, a sure sign of an accurate lunisolar year. The language
     used is astronomical, and it confirms the reports written in ancient Middle Eastern and Mediterranean
     writings that Zarathushtra was an outstanding astronomer also.  It also confirms the statement in post-
     Sassanian Iranian astronomy books that Zarathushtra built an observatory in Zabol, Sistan (eastern Iran)
     and that it was inaugurated on 21st March 1725 BCE, the day King Vishtaspa and his courtiers converted,
     chose the Good Religion and joined the Zarathushtrian Fellowship.  It also provides us with the clue that
     the Good Religion was founded by Zarathushtra, exactly twelve years earlier on vernal equinox of 1737 BCE.
     The Vispered, dedicated only to the six seasonal festivals, the "Gaahaanbaars", also shows that the early
     Zarathushtrian calendar was almost the old Indo-Iranian lunisolar calendar with its waxing and waning lunar
     phases. The month was based on moon's phases, and the year was calculated on the solar basis.  The
     difference was corrected by an intercalation of eleven days at the end of the year on the Hamaspathmaidhaya
     Gahanbar of the vernal equinox. This was 0.12484 day or 2.99616 hours shorter. Only a further intercalation
     of one day after eight years (precisely after 8.010253 years), could keep the seasonal festivals in their
     proper places. How did the Gathic people correct it, we do not know. We know this much that no complaint
     has been recorded by them about the festivals drifting away from their relevant agricultural seasons.
     Sometime during the later Avestan age, the year was made into a purely solar year of 365 days with twelve
     months of thirty days and the five "Gatha" days as the intercalary period. Should we believe a 9th century
     Pahlavi tradition, the correction of five hours and a fraction was made good every four years, or the
     community had to wait for 40 years to intercalate 10 days or still more for 120 years to add a thirteenth
     month of 30 days. The usual reference to one month intercalation at the end of 120 years only reminds us of
     the disorder that prevailed during the last days of the Sassanian Empire and its subsequent fall.

THE LEAP YEAR

     A point about intercalation in a ``leap'' year: The precise time of vernal equinox is determined by the
     International Meridian, at present Greenwich. The usual way is to count the year of 365 days and 6 hours.
     Four 6 hours, or one day, is added to bring back the year on the right track. This fourth year is called
     the ``leap year'' because it leaps one day ahead. But the actual length of the year is 6 hours but 5 hours
     48 minutes and 45.5 seconds, a difference of 11 minutes and 14.5 seconds.  This amount to one day in 128
     days. It was to correct this that the leap years are those eras which are divisible by 400. Even this makes
     the Christian or Common year 26 seconds longer than the tropical year.  The Iranian calendar does not have
     this problem. Its new year begins exactly at the beginning of the equinox. Although the formal Iranian year
     of the present days has its leap year, it should never worry about it.  All it has to do is to see that if
     the right times falls after midnight 0 hours 00 minutes and 01 seconds to 0 hours 00 minutes and 00 seconds
     -- the first day of the year also begins with it. This is because the Avestan day begins with the ``Ushahin
     Gaah,'' the Dawn Time, which begins from midnight. Yes, the Iranians have been counting their day from
     midnight for, at least, 3738 years and it is the West that has adopted it very late in our times. The
     Iranian calendar DOES NOT need a leap year at all. It is automatically within the right time. I hope that
     one day the authorities concerned would realize this FACT and amend the calendar by eliminating the so-
     called leap year.

CALENDAR NAMES

     Each of the twelve Avestan months and thirty days were named after a deity, some of them old Aryan gods and
     goddesses discarded by Zarathushtra but reintroduced later by authoritative priests, and some of them
     Gathic principles personified by the same priests into divine entities, all now called yazatas, meaning
     "venerated, venerable."  "Year" in general was called "yaairi" or "yaari", but the intercalated solar year
     was known as "saredha", Old Persian of the Achaemenians "tharda", and Pahlavi and modern Persian "saal"
     (compared Sanskrit "sharad", autumn, year).  This calendar is followed to this day by Iranian Zartoshtis
     and some Parsis. It is called Fasli, a modern Persian-Arabic word meaning "seasonal" However, majority of
     Parsis use Shahenshahi, the "Imperial" calendar. The Parsis have not intercalated since 1126 CE.  It now
     begins in the last week of August 21st, full seven months plus one day earlier. The Iranian Zoroastrians,
     who follow the Qadimi Calendar, have abandoned intercalation since 1006 CE and the 365-day year has now
     forwarded their new year day by eight months. As seen, the two calendars are neither precisely "Gathic" nor
     astronomically scientific. So is the present Zoroastrian era of 1370 followed by the Shahenshahis, Qadimis
     and Parsi Faslis. It is based on the ascension of the last Sassanian king Yazdegerd III (632-642 CE + 10
     years of wandering until his murder by Khosrow the miller) and has no religious significance at all.
     Fortunately, with the exception of a minute number, mostly residing in India, all Iranian Zoroastrians have
     given up the Qadimi calendar in favor of the Fasli one, and they reckon the Zarathushtrian Religious Era as
     the beginning. At present there is a move to unify all Zoroastrians, at least in North America and Europe,
     to adopt the Fasli calendar.

NAMES OF SEASONAL TIMINGS

     The Gaahaanbaars: The agricultural people were in tune with nature in their day-to-day life. They fully
     knew the solar and lunar movements and the changes in the seasons. They had timed their activities to suit
     the climate in which they lived. This timetable was kept in step with saredha, the tropical solar year of
     365 days, 5 hr, 48 min, and 45.5 sec, but differed a little on certain points.  Their activities were
     scheduled to correspond with various phases of their agricultural life on the Iranian Plateau. It was
     divided into six phases. The end of one phase and the beginning of other were celebrated as a special time
     of festivity. The six seasonal festivals were: (1) Hamaspathmaidhaya, meaning "vernal equinox," the 1st day
     of Farvardin, the beginning of spring, on or about 21st March, was to celebrate the end of the old year and
     the beginning of the new year. It was, according to the Avesta, the time to "properly set" everything and
     prepare for the new year.  (2) Maidhyoi-zaremaya (Mid-spring), 14th day of Ardibehesht, on or about 4th
     May, was the time to celebrate the occasion for the cattle having delivered their young and yielded
     "abundance of milk" and also for appraising the crops sown in late winter or early spring.  (3) Maidhyoi-
     shema (Midsummer), 12th day of Tir, on or about 3rd July, was the beginning of the harvesting season.  (4)
     Paitish-hahya (Grain-reaping), 25th day of Shahrivar, on or about 16th September, marked the end of
     harvesting.  (5) Ayaathrema (no-travel), 24th day of Mehr, on or about 16th October, was to enjoy the end
     of trade caravans and the time to mate cattle before the winter set in.  (6) Maidhyaairya (Midyear), 15th
     day of Dey, on or about 4th January, heralded the passing of the winter peak and for making preparations to
     meet the spring with agricultural activity.

     Only the first two festivals coincided with the solar seasonal changes. The others were purposely put off
     to meet the living conditions. They were not calendarically or traditionally bound but were very practical
     people, a point to note.  Most probably the festivals were celebrated with sacrifices to gods and goddesses
     and by indulging in a joyous festivity.  Gahanbars and Zarathushtrians: Asho Zarathushtra, born in an
     agricultural environment, preached and spread his Good Religion among people engaged in crop cultivation
     and animal husbandry. His dynamic message introduced a completely new order in spiritual, or better, as he
     put it, mental sphere and purged out all evil and superstitious thoughts, misleading words, harmful deeds,
     and superficial, superfluous rituals, but helped to strengthen and promote all the then-existing
     constructive activities of a good living.  And the Gahanbars were one of the constructively enjoyable
     festivals.

Chanting and Feasting:

     Avestan evidences, particularly the book of Vispered, show that the early Zarathushtrians turned the
     Gahanbar into an occasion to fit into their new pattern of life. Each festival was traditionally celebrated
     for one and later for five days. They were devoted to reciting, chanting, explaining, understanding, and
     holding questions-and-answers on each of the five Gathas of Asho Zarathushtra. The festival was rounded up
     with a feast prepared by collective participation and efforts, and merrymaking.  A piece in the Avesta
     directs that all participants should bring whatever they can afford;  dairy products, meat, vegetables,
     legumes, grain, other food ingredients, and firewood. If one was not in a position to contribute in kind,
     one might put his or her labor in preparing the food in a common pot, or just join the prayers. The food,
     with a large variety of ingredients, was a tasty stew, resembling today's more sophisticated Iranian "aash"
     or the Parsi spiced "dhansaak", both relished on the occasion. Merrymaking was the folk music and dances
     still observed among Iranian tribes all over the Iranian Plateau and beyond.  The Zarathushtrian Assembly
     celebrates the Gahanbars with a relevant Gahanbar prayer, Gatha recital and explanation, a brief talk on an
     interesting subject, potluck lunch, friendly conversation, and music and dance.

Vedic Calendar:

     It may be noted that the Indo-Aryans had also six seasons (Sanskrit rtu, Avestan ratu) evidently modified
     to meet the climate in the Indus Valley. They were: Vasanta (Spring), Grishma (Summer), Varsha (The Rains),
     Sharad (Autumn), Hemanta (Winter), and Shishira (the Cool season). Persians and Other Iranian Calendar: The
     Achaemenians, Sogdians, Chorasmians, and Armenians, all Zoroastrians by faith, had their own names for
     their months. The names of the Achaemenian months, as given in the bas-reliefs of Darius the Great are
     rendered to convey (1) Irrigation-canal-cleaning month, (2) Vigorous spring, (3) Garlic-collecting month,
     (4) Hot-step, (7) God-veneration, (8) Wolf-birth, (9) Fire-veneration, (10) Anaamaka -- Nameless month, and
     (12) Digging-up. Three names have not been given in Old Persian but we have their Elamite pronunciations
     and all, except two, are nonreligious terms. The Achaemenians had numbers instead of names for the days of
     the month. (see Old Persian, Ronald G. Kent, 2nd ed., New Haven, 1953).  That confirms that the months as
     well as the days named after pre-Zarathushtrian deities and post-Zarathushtrian personifications of Gathic
     abstracts is a later addition.  There are indications that it was done during the reign of Artaxerxes II
     (405-359 BCE), and that naming the months and days in honor of deities were adopted from the Egyptians.
     The names of the Gahanbars, and those of the Vedic, Achaemenian, Sogdian, Chorasmian, and Armenian months
     show that the names of the pre-Zarathushtrian and Gathic months must have been based on the seasons and
     social activities, and not on deities.  These old names have, however, been so well obliterated by the
     authoritarian priests that we do not have any inkling of what they were.

Later Avestan Calendar:

     The names of the twelve months in modern Persian and their Avestan forms with their corresponding Zodiac
     names are

     1. Farvardin   Fravashi/Fravarti   Aries       21 March

     2. Ardibehesht Asha Vahishta       Taurus      21 April

     3. Khordaad    Haurvataat          Gemini      22 May

     4. Tir         Tishtrya            Cancer      22 June

     5. Amordaad    Ameretaa            Leo         23 July

     6. Shahrivar   Khshathra Vairya    Virgo       23 August

     7. Mehr        Mithra              Libra       23 Sept

     8. Aabaan      Ap                  Scorpio     23 Oct

     9. Aazar       Aathra              Sagittarius 22 Nov

     10. Dey        Dathva              Capricorn   22 Dec

     11. Bahman     Vohu Manah          Aquarius    21 Jan

     12. Esfand     Spentaa Aaramaiti   Pisces      20 Feb

     Note: Of these only those in bold letters are the Gathic "Primal Principles of Life," Aazar/Aathra has been
     mentioned in the Gathas as the symbol of the Progressive Mentality (Spenta Mainyu), and "ap" (water) is
     also mentioned in the Gathic texts, but the rest are later Avestan names.

THE WEEK

     The early Avestan people had no notion of the week, a period of seven days now in universal use as a
     division of time. Week is a man-made unit. Its length has, among various people, been from five to ten
     days. But since the lunar month, one of the earliest ways of reckoning time, is alternately of 29 and 30
     days with two phases of waxing and waning moon, it was quite easy to further divide it and have four
     quarters of seven and eight days accommodated in it. The seven planets visible to the naked eye may have
     also played a part in its formation. That is why weekdays are named after celestial bodies. However, the
     present universal week is most probably of Chaldean or Hebrew origin, and has been generalized by Jewish,
     Christian and Islamic persuasion.  The later Avestan solar calendar, based on thirty days in a month, has
     four quarters -- the first two of seven days and the last two of eight days. But Avesta and Pahlavi do not
     have any names for each of these quarters or for the weekdays. Modern Persian follows the Hebrew pattern of
     having Saturday as Shanbeh, Persianized form of "Shabbath", and then counting from one to five as Yek-
     shanbeh, Do-shanbeh, Se-shanbeh, Chahaar-shanbeh, Panj-shanbeh, and under the Islamic influence, Aadineh or
     Jom'eh for Friday, the day of mass prayers.

ERAS

     Pahlavi writings tell us that the religious era began from the day Zarathushtra proclaimed his Divine
     Mission to humanity.  This era, based on the astronomical calculations that Zarathushtra declared his
     mission on the vernal equinox when, according to the precession, the period of Aries is supposed to have
     begun, comes to be 3738/39 in 2001 CE i.e. 1737 BCE. It has been called the "Year of Religion" in Pahlavi
     writings. The Zarathushtrian Assembly calls it the Zarathushtrian Religious Era (Z.E.R./ZRE) and has, since
     its establishment in 1990, observed it as the beginning of the Zarathushtrian calendar.  The Zartoshti
     community in Iran joined in to observe ZRE as its calendar in 1993, and many Irani Zartoshtis in diaspora
     have also accepted it.  Earlier, each of the Iranian kings, following the pattern set by other Middle
     Eastern rulers, particularly the Babylonians, observed a new era from his own ascension to the throne.
     With as many as 80 rulers on the Iranian throne during the thousand and odd years of Achaemenians,
     Macedonians, Parthians, and Sassanians, much confusion in chronology has arisen, and many dates have been
     misinformed, misused, misplaced, misinterpreted, miscalculated, and missed.  The Yazdgerdi era reminds one
     of the last Emperor who got overthrown by Arab invaders.  It is not a happy recollection.  Sassanians and
     Two Calendars: The Sassanians continued to maintain both the "yaairi" of 365 days and the "saredha" of
     365.24224 days.  The first they called "oshmurdik" meaning "rememberable, reckonable" and the second
     "vihezakik" meaning "moving, progressive, intercalary."  While the "rememberable" was easy for the laity to
     memorize and count them by names, the "intercalary" belonged to the astronomer priests, linked with the
     imperial court, to keep the formal year precise and in tune with the seasons.  The fall of the Sassanian
     Empire fell the astronomer priests of their high position.  Nevertheless, the intercalary year was, Pahlavi
     books and the present position of the Qadimi and Shahenshahi calendars tell, kept until the 11th century
     CE.  The decline of astronomer priests put an end to Vihezakik and the lay priests have continued with
     their "Ushmordik," advancing about one day in every four years out of the season and the solar year.
     Economic and seasonal revenue collection, however, forced the Muslim Caliphs to maintain, evidently by
     those astronomer priests who had embraced Islam, the intercalary year in addition to the Islamic calendar
     of a purely lunar year.  It was this Vihezakik year maintained halfheartedly by Muslim rulers, which was
     improved, perfected and formally restored by Omar Khayyam and other Iranian scientists.  It was named the
     "Jalaali" calendar after its patron, Sultan Jalal al-Din Malekshah Saljuqi (1072-1092 CE).  The Fasli year,
     officially observed by Iranians -- Zartoshtis, Jews, Christians, and Muslims -- in modern Iran, is the
     "saredha" of the Avestan people, "tharda" of the Achaemenian, "Vihezakik" of the Sassanians, and the
     "Jalali" of Omar Khayyam.  The precise solar year also reckoned by all observatories in the world. It is
     the Universal Astronomical and Scientific Year.  It is this Vihezakik (Persian "Behizaki") calendar, now
     called "Khorshidi" (solar), the official Iranian calendar, the precise calendar, with its dates numbered,
     that the Zarathushtrian Assembly follows.  It is astronomically precise.  It is progressively
     Zarathushtrian.

HISTORY

     NO HISTORY.

OTHER VERSIONS

     No other versions rumor to exist.

AUTHOR

     Written by Ashkan Ghassemi. <ghassemi@ftml.net>

REPORTING BUGS

     Report jcal bugs to <ghassemi@ftml.net> libjalali home page: <http://savannah.nongnu.org/projects/jcal/>

SEE ALSO

     jdate (1), jctime (3), jstrftime (3), jstrptime (3)

COPYRIGHT

     Copyright (C) 2011 Ashkan Ghassemi.  License GPLv3+: GNU GPL version 3 or later
     <http://gnu.org/licenses/gpl.html>.  This is free software: you are free to change and redistribute it.
     There is NO WARRANTY, to the extent permitted by law.