JalaliJSCalendar is a JavaScript DHTML Calendar that is based on "
Dynarch DHTML Calendar" from "Mihai Bazon".
The main difference between two is that JalaliJSCalendar supports Persian (Hijri Shamsi) Calendar too, that is the official iranian calendar and there is also some bug fixes in it.
JalaliJSCalendar is free and open source and released under the terms of
GPL (GNU General Public License).
Dynamic Demo
JalaliJSCalendar Features
- Supports both Gregorian and Jalali Calendars.
- The look is customizable through external CSS
- High quality color themes
- Keyboard navigation
- Can show days from adjacent months
- Can show week numbers
- Translated into many languages
- Any day can be “the first day of week”
- The default “first day of week” can be configured in the language file
- One can easily jump back or forward with 24 years
- Provides help hints (also configurable)
- Includes an optional time selector with 1 minute resolution
- Special days (configurable list of days that are displayed differently)
- Allows multiple days selection
- Fast and very easy to setup
Supported browsers
- Internet Explorer 5.0+ for Windows
- Mozilla, Netscape 7.x, Mozilla FireFox (any platform)
- Other Gecko-based browsers (any platform)
- Konqueror 3.2+ for Linux
- Apple Safari for Macintosh and Windows
- Opera 7+ (any platform)
Known Issues
- The result of getJalalliWeekNumber function may be incorrect.
I couldn't find the official defination of week number in Jalali calendar.
I have implemented this function with the assumption that "the week that contains
the first Saturday of the year is the first week of that year."
if you know any official defination, please let me know.
- Since 'am' and 'pm' strings moved to language files, all language files should be updated as soon as possible.
Version History
- v1.4 - April 15, 2009
- Ability to select an entire row or column just with one click in multiple mode (Thanks to Emil Sedgh)
- Some bugs in setup script fixed (Thanks to Emil Sedgh)
- position bug in IE7 fixed (Thanks to Sina Salek).
- v1.3 - February 04, 2009
- ability to automatically fill input field and display area on initialize.
- bug fixed in setting initial date value.
- v1.2 - September 11, 2008
- ability to set a different dateType for input field added.
- bug fixed in setDateType method.
- v1.1.5 - July 27, 2008
- New feature added to show popup calendars when their input field gets focus. (Thanks to Emil Sedgh)
- v1.1 (Stable Release) - July 11, 2008
- Implementation of getJalaliUTCWeekNumber method corrected. (Thanks to Nima Shayafar)
- Bug fixed in getJalaliUTCDayOfYear method.
- getJalaliDay and getJalaliUTCDay methods added.
- Bug fixed in parseDate method (now handles milliseconds correctly)
- Some other bugs fixed.
- v1.1 beta - June 7, 2008
- Some methods added to handle the calendar more dynamically.
- Direction of calendar can be defined in language files.
- Fixed bug in keyboard navigation with right to left languages.
- Fixed bug in parseDate function with hours greater that 19.
- Now setup function returns the calendar object.
- Cache parameter removed from setup parameters.
- v1.0 beta - June 3, 2008
- The project started based on Dynarch calendar.
- Jalali extentions for Date Object added.
- dateType property added to Calendar class.
- Number characters for each language can be defined in its own file.
- Using language specific number characters is optional through langNumbers property.
- "am" and "pm" strings moved to language files.
- parseDate method is completely rewritten since it was very buggy.
- setFullYear bug fixed by using a custom function instead of changing the orginal one.
- Flat calendar bug with hidden inputs fixed.
- DST bug fixed by using UTC functions instead of local functions.
Where it is used?
If you have used JalaliJSCalendar in your project, and you would like your project to be listed here, please send a link to your project's homepage and a brief description about it to me via
email.
Feel free to contact me for any comments or bug reports.
ali [at] farhadi [dot] ir
