Tuesday, November 4, 2025
HomejQueryjQuery Plugin for World Calendars - calendars

jQuery Plugin for World Calendars – calendars


calendars is a strong jQuery plugin which offers implementations of assorted world calendars and extra performance similar to conversion between calendars, parsing and formatting dates, and a datepicker.

Options:

  • Calendars: Gregorian, Julian, Taiwanese, Thai, Persian, Islamic, Hebrew, Ethiopian, Coptic, Mayan.
  • Parse and format dates in all these calendars.
  • Model the datepicker utilizing one in all 5 themes, or use any of the usual Themeroller themes.
  • Over 70 localisations for Gregorian/Julian calendars.

Primary Utilization:

1. Embody jQuery library and calendars.js in your html doc.


<script src="/path/to/jquery.min.js"></script>
<script src="/path/to/jquery.calendars.js"></script>

2. Embody the modules of your alternative within the doc. Out there modules:


<!-- additional capabilities assist: determineDate | formatDate | parseDate -->
<script src="js/jquery.calendars.plus.js"></script>

<!-- date picker module -->
<script src="js/jquery.calendars.picker.js"></script>

<!-- superior date picker module -->
<script src="js/jquery.calendars.picker.ext.js"></script>

<!-- Taiwanese calendar -->
<script src="js/jquery.calendars.taiwan.js"></script>

<!-- Thai calendar -->
<script src="js/jquery.calendars.thai.js"></script>

<!-- Julian calendar -->
<script src="js/jquery.calendars.julian.js"></script>

<!-- Persian calendar -->
<script src="js/jquery.calendars.persian.js"></script>

<!-- Islamic calendar -->
<script src="js/jquery.calendars.islamic.js"></script>

<!-- Hebrew (civil) calendar -->
<script src="js/jquery.calendars.hebrew.js"></script>

<!-- Ethiopian calendar -->
<script src="js/jquery.calendars.ethiopian.js"></script>

<!-- Coptic calendar -->
<script src="js/jquery.calendars.coptic.js"></script>

<!-- Nepali calendar -->
<script src="js/jquery.calendars.nepali.js"></script>

<!-- Nanakshahi calendar -->
<script src="js/jquery.calendars.nanakshahi.js"></script>

<!-- Mayan (Lengthy Rely) calendar -->
<script src="js/jquery.calendars.mayan.js"></script>

<!-- Discworld calendar -->
<script src="js/jquery.calendars.discworld.js"></script>

3. Get hold of a calendar implementation and begin utilizing it.


var gc = $.calendars.occasion(); 
var d = gc.newDate(2009, 1, 26);

4. Default plugin choices.


// The calendar for this datepicker.
calendar: $.calendars.occasion(),

// CSS class so as to add to this occasion of the datepicker.
pickerClass: '',

// true for popup on focus, false for not.
showOnFocus: true,

// Aspect to be cloned for a set off
showTrigger: null,

// Identify of jQuery animation for popup
showAnim: 'present',

// Choices for enhanced animations.
showOptions: {},

// Length of show/closure.
showSpeed: 'regular',

// The ingredient to which a popup calendar is added
popupContainer: null,

// Alignment of popup
// 'high' or 'backside' aligns relying on language route,
// 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'.
alignment: 'backside',

// true to at all times present 6 weeks
// false to solely present as many as are wanted.
fixedWeeks: false,

// First day of the week, 0 = Sunday, 1 = Monday, and many others.
firstDay: null,

// Calculate week of the yr from a date,
calculateWeek: null,

// true to localise numbers (if out there),
// false to make use of regular Arabic numerals.
localNumbers: false,

// What number of months to point out, cols or [rows, cols].
monthsToShow: 1,

// What number of months to offset the first month by;
// could also be a perform that takes the date and returns the offset.
monthsOffset: 0,

// What number of months to maneuver when prev/subsequent clicked.
monthsToStep: 1,

// What number of months to maneuver when massive prev/subsequent clicked.
monthsToJump: 12,

// true to make use of mousewheel if out there
useMouseWheel: true,

// true to alter month/yr through drop-down
// false for navigation solely
changeMonth: true,

// Vary of years to point out in drop-down: 'any' for direct textual content entry
// or 'begin:finish', the place begin/finish are '+-nn' for relative to at the moment
// or 'c+-nn' for relative to the at present chosen date
// or 'nnnn' for an absolute yr.
yearRange: 'c-10:c+10',

// trueto present dates from different months
showOtherMonths: false,

// true to permit choice of dates from different months too.
selectOtherMonths: false,

// Date to point out if no different chosen.
defaultDate: null,

// true to pre-select the default date if no different is chosen.
selectDefaultDate: false,

// The minimal selectable date.
minDate: null,

// The utmost selectable date.
maxDate: null,

// Format for dates.
dateFormat: null,

// true to dimension the enter discipline in line with the date format.
autoSize: false,

// Permits for choosing a date vary on one date picker.
rangeSelect: false,

// Textual content between two dates in a variety.
rangeSeparator: ' - ',

// Most variety of selectable dates, zero for single choose.
multiSelect: 0,

// Textual content between a number of dates.
multiSeparator: ',',

// Callback as a date is added to the datepicker.
onDate: null,

// Callback simply earlier than a datepicker is proven.
onShow: null,

// Callback when a brand new month/yr is chosen.
onChangeMonthYear: null,

// Callback when a date is chosen.
onSelect: null,

// Callback when a datepicker is closed.
onClose: null,

// Alternate discipline to replace in synch with the datepicker.
altField: null,

//  Date format for alternate discipline
altFormat: null,

// true to constrain typed enter to dateFormat allowed characters.
constrainInput: true,

// true to use formatDate to the command texts.
commandsAsDateFormat: false,

// Command actions which may be added to a structure by title.
instructions: {} 

Extra Examples:

Changelog:

v2.2.0 (2025-03-22)

v2.1.2 (2019-10-23)


This superior jQuery plugin is developed by kbwood. For extra Superior Usages, please examine the demo web page or go to the official web site.

RELATED ARTICLES

LEAVE A REPLY

Please enter your comment!
Please enter your name here

Most Popular

Recent Comments