dojox.date.islamic¶
| Contributor: | Hossam Katory |
|---|---|
| since: | V1.4 |
Contents
Implements the traditional Islamic (Hijri) calendar. This is the civil calendar in Saudi Arabia and the liturgical calendar of the Islamic faith worldwide.
Introduction¶
The Islamic calendar (Hijri calendar) is a purely lunar calendar. It contains 12 months that are based on the motion of the moon, and because 12 synodic months is only 12 x 29.53=354.36 days, the Islamic calendar is consistently shorter than a tropical year, and therefore it shifts with respect to the Gregorian calendar. The calendar is based on the Qur’an (Sura IX, 36-37) and its proper observance is a sacred duty for Muslims.
Usage¶
Code snippet below illustrates most common usage of Islamic calendar.
<head>
<script type="text/javascript">
dojo.require("dojox.date.islamic");
dojo.require("dojox.date.islamic.Date");
dojo.require("dojox.date islamic.locale");
</script>
<title> Islamic calendar </title>
</head>
<body>
<input id="Hijcal"
name="noDOMvalue"
value="2009-03-10"
type="text"
data-dojo-type="dijit.form.DateTextBox"
datePackage = "dojox.date.islamic"
constraints="{min:'2008-03-01',max:'2009-04-01',datePattern:'dd MMMM yyyy'}">
</body>
Islamic calendar package¶
Islamic calendar package comprises of following two files:
- dojox.date.islamic.Date implements logic of Islamic calendar and provides support for date conversion between Gregorian and Islamic calendars
- dojox.date.islamic.locale includes implementation of functions responsible for conversion between two possible representations of Islamic date: String representation and Date object. It also provides date formatting capabilities.
Islamic calendar and DateTextBox¶
Islamic calendar implemented in this package can be used in conjunction with DateTextBox in order to provide graphical date picker for Islamic calendar. For example, image below illustrates DateTextBox using Islamic calendar with default language set to Arabic.
Examples¶
Programmatic example¶
The code snippet below illustrates conversion between two possible representations of Islamic date: String and Date object.
var options = {datePattern:'EEEE dd MMMM yyyy HH:mm:ss', selector:'date'};
// converts string representation of Islamic date to Date object
var dateHij = dojox.date.islamic.locale.parse("الأربعاء 04 صفر 1431 12:30:25", options);
// formats Islamic date object and serialize it into a string
var dateHijString = dojox.date.islamic.locale.format(dateHij, options);
Declarative example¶
Code snippet below illustrates usage of Islamic calendar in the context of graphical date picker - DateTextBox
<head>
<script type="text/javascript">
dojo.require("dojox.date.islamic");
dojo.require("dojox.date.islamic.Date");
dojo.require("dojox.date.islamic.locale");
</script>
<title> Islamic calendar </title>
</head>
<body>
<input id="hijcal"
name="noDOMvalue"
value="2009-03-10"
type="text"
data-dojo-type="dijit.form.DateTextBox"
datePackage = "dojox.date.islamic"
constraints="{min:'2008-03-01',max:'2009-04-01',datePattern:'dd MMMM yyyy'}">
</body>
See also¶
Islamic Calendar: http://en.wikipedia.org/wiki/Islamic_calendar Islamic Calendar History and Motivation: http://www.al-inaam.com/library/calendar3.htm