Calendar Description - Scheme i
The Islamic calendar is a lunar calendar used throughout the Arabic and Muslim areas.
Use Case
This arithmetical version is commonly used for planning purposes and where details of the calendar being used is unknown.
Definition
| Record | |||
|---|---|---|---|
| year | month | day | wsday |
The year consists of twelve lunar months which in a common year alternate between of 30 and 29 days. In a leap year, the 12th month has 30 days instead of the usual 29. A common year has 354 days and a leap year 355 days.
Leap years occur on a 30 year cycle in years 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 and 29.
The Epoch is set at the civil epoch, which is:-
=
=
.
| i | year | month | day |
|---|---|---|---|
| 1 | 1 | 1 |
| j | year | month | day |
|---|---|---|---|
| 622 | 7 | 16 |
| jdn | day |
|---|---|
| 1948440 |
| Month Names - Lexicon im | ||||
|---|---|---|---|---|
| Number | Name | Number of Days | ||
| Full | Abrev. | Common | Leap | |
| 1 | Muḥarram | Muharram | 30 | 30 |
| 2 | Ṣafar | Safar | 29 | 29 |
| 3 | Rabī‘ al-Awwal | Rabi' I | 30 | 30 |
| 4 | Rabī‘ al-Ākhir | Rabi' II | 29 | 29 |
| 5 | Jumādá al-Ūlá | Jumada I | 30 | 30 |
| 6 | Jumādá al-Ākhira | Jumada II | 29 | 29 |
| 7 | Rajab | Rajab | 30 | 30 |
| 8 | Sha‘bān | Sha'aban | 29 | 29 |
| 9 | Ramaḍān | Ramadan | 30 | 30 |
| 10 | Shawwāl | Shawwal | 29 | 29 |
| 11 | Dhū al-Qa‘dah | Dhu al-Qi'dah | 30 | 30 |
| 12 | Dhū al-Ḥijjah | Dhu al-Hijjah | 29 | 30 |
| Week Names - Lexicon iw | ||
|---|---|---|
| Number | Name | |
| Full | Abrev. | |
| 1 | Yawm al-Aḥad | Ahad |
| 2 | Yawm al-Ithnayn | Ithn |
| 3 | Yawm ath-Thulāthāʼ | Thal |
| 4 | Yawm al-Arbi‘ā’ | Arda |
| 5 | Yawm al-Khamīs | Kham |
| 6 | Yawm al-Jumu‘ah | Jumu |
| 7 | Yawm as-Sabt | Sabt |
Formats
The formats supplied with this scheme.
| Formats - Grammar i | |||||
|---|---|---|---|---|---|
| Code | Rule | Pseudo:in | Pseudo:out | Example | Note |
| dmy | text | day month year | dd Month yyyy | 22 Dhū al-Ḥijjah 1445 | D, S |
| dmy_a | text | day month year | dd Mon yyyy | 22 Dhu al-Hijjah 1445 | S |
| dmy_d | text | day month year | dd mm yyyy | 22 12 1445 | S |
| wdmy | text | wsday day month year | Weekday dd Month yyyy | Yawm as-Sabt 22 Dhū al-Ḥijjah 1445 | |
| wdmy_a | text | wsday day month year | WDay dd Mon yyyy | Sabt 22 Dhu al-Hijjah 1445 | |
| ymd | text | year month day | yyyy Mon dd | 1445 Dhu al-Hijjah 22 | S |
| def | text | year month day | yyyy mm dd | 1445 12 22 | H, S |
| u | unit | 9y 9m 9d | 9y 9m 9d | 1445y 12m 22d | H |
| Notes: D = Default, H = Hidden, S = Range shortcut supported. Example based on jdn# 2460491 | |||||
Script
| Script - Module hics:islamic |
|---|
| lexicon im { name "Islamic Month names"; fieldname month; lang en; pseudo Month, Mon; tokens { 1, "Muḥarram", "Muharram"; 2, "Ṣafar", "Safar"; 3, "Rabī‘ al-Awwal", "Rabi' I"; 4, "Rabī‘ al-Ākhir", "Rabi' II"; 5, "Jumādá al-Ūlá", "Jumada I"; 6, "Jumādá al-Ākhira", "Jumada II"; 7, "Rajab"; 8, "Sha‘bān", "Sha'aban"; 9, "Ramaḍān", "Ramadan"; 10, "Shawwāl", "Shawwal"; 11, "Dhū al-Qa‘dah", "Dhu al-Qa'dah"; 12, "Dhū al-Ḥijjah", "Dhu al-Hijjah"; } } lexicon iw { name "Islamic Weekday names"; fieldname wsday; // Note: Days are numbered from Sunday, unlike "wday". lang en; pseudo Weekday, WDay; tokens { 1, "Yawm al-Aḥad", "Ahad"; // Sunday 2, "Yawm al-Ithnayn", "Ithn"; // Monday 3, "Yawm ath-Thulāthāʼ", "Thul"; // Tuesday 4, "Yawm al-Arbi‘ā’", "Arbi"; // Wednesday 5, "Yawm al-Khamīs", "Kham"; // Thursday 6, "Yawm al-Jumu‘ah", "Jumu"; // Friday 7, "Yawm as-Sabt", "Sabt"; // Saturday } } grammar i { fields year month day; optional wsday; lexicons im iw; alias pseudo { w wsday; dd day; mm month; yyyy year; } alias unit { d day; m month; y year; } format dmy "{day} |{month:im} |{year}"; format dmy_a "{day} |{month:im:a} |{year}"; format dmy_d "{day} |{month} |{year}"; format wdmy "{wsday:iw} |{day} |{month:im} |{year}"; format wdmy_a "{wsday:iw:a} |{day} |{month:im:a} |{year}"; format ymd "{year}| {month:im:a}| {day}"; preferred dmy; } scheme i { name "Islamic Tabular"; base islamic IIc; grammar i; } |
Note, the use of optional field "wsday" in which the week starts on Sunday (day 1).
