OnWorks favicon

idate - Online in the Cloud

Run idate in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command idate that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



idate - A Gregorian/Meladi to/from Hijri/Islamic date converter


idate [--gregorian yyyymmdd] [--hijri yyyymmdd] [--simple] [--umm_alqura] [--help]


The idate program is a Gregorian to Hijri (and vice-versa) date converter. The
application uses and offers multiple calculation methods with not all of them agreeing at
all times. The reason for this multiplicity is due to not having one agreed upon method
and so various entities develop and advocate their calculations.

idate is able to comprehend and calculate both pre-epoch or pre-Hijrah, denoted as "B.H",
as well as post-epoch or post-Hijrah, denoted as "A.H", dates. idate also utilizes
Gregorian's pre-epoch "B.C" and post-epoch "A.D" dates and notes them per its output.
When entering pre-epoch years, negative numbers ought to be utilized.

idate when run without any command-line options uses the host machine's current Gregorian
date and converts it to Hijri.


idate follows the usual GNU command line syntax, with long options starting with two
dashes (`-'). A summary of all options is noted below:

-h, --help
Show summary of options

-g, --gregorian yyyymmdd
Specify the Gregorian date to be converted where 'y' stands for year, 'm' for month
and 'd' for day

-hi, --hijri yyyymmdd
Specify the Hijri date to be converted where 'y' stands for year, 'm' for month and
'd' for day

-s, --simple
Specify a simplified output mode

-u, --umm_alqura
Specify to use the Umm Al-Qura calculation method (used mostly in Saudi Arabia)


The Hijri calendar is used in most of the Arab world and is the symbolic calendar of the
Islamic faithed worldwide. This calendar is known as the "Hijri" (based on the word
"Hijrah" - denoting migration in Arabic) to signal Prophet Mohammed's (PBUH) migration
from Makkah to Medinah on Thursday, July 15, 622 AD (Julian) or July 19, 622 AD

The Islamic Hijri calendar is strictly lunar (ie. moon-based) with twelve lunar months
which do not correspond or track their solar counterparts (the Gregorian calendar is a
solar or sun-based calendar). Lunar years and thus Hijri years are, on average, about 354
days long resulting in a Hijri year being roughly about 11 days shorter than its Gregorian

There is much discussion and confusion regarding how best to track the Hijri calendar. A
great deal of that confusion is based on the fact that many rely on a human moon sighting
to denote the start (or end) of a month (each month of the Hijri calendar starts when a
new moon's crescent is observed or is made visible at sunset) as opposed to using an
empirical mathematic certainty. The methods presented in this application and its
underlying ITL library are strictly arithmetic in nature and do NOT take moon-phases into
consideration (in short, observational approximation is not used).


The Umm Al-Qura option doesn't function with pre-epoch settings.


Report bugs on the web using http://bugs.arabeyes.org

Use idate online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

Linux commands