Provides support for various world calendars in a consistent manner.
Use the global instance, $.calendars, to access the functionality.
year specified above).
@param {number} [day] The day for the date (if numeric year specified above).
@param {BaseCalendar|string} [calendar='gregorian'] The underlying calendar or the name of the calendar.
@param {string} [language=''] The language to use for localisation (default English).
@return {CDate} The new date.
@throws Error if an invalid date.
@example $.calendars.newDate()
$.calendars.newDate(otherDate)
$.calendars.newDate(2001, 1, 1)
$.calendars.newDate(1379, 10, 12, 'persian') */
newDate: function(year, month, day, calendar, language) {
calendar = ((typeof year !== 'undefined' && year !== null) && year.year ? year.calendar() :
(typeof calendar === 'string' ? this.instance(calendar, language) : calendar)) || this.instance();
return calendar.newDate(year, month, day);
},
/** A simple digit substitution function for localising numbers via the
{@linkcode GregorianCalendar.regionalOptions|Calendar digits} option.
@memberof Calendars
@param {string[]} digits The substitute digits, for 0 through 9.
@return {CalendarsDigits} The substitution function.
@example digits: $.calendars.substituteDigits(['۰', '۱', '۲', '۳', '۴', '۵', '۶', '۷', '۸', '۹']) */
substituteDigits: function(digits) {
return function(value) {
return (value + '').replace(/[0-9]/g, function(digit) {
return digits[digit];
});
};
},
/** Digit substitution function for localising Chinese style numbers via the
{@linkcode GregorianCalendar.regionalOptions|Calendar digits} option.
@memberof Calendars
@param {string[]} digits The substitute digits, for 0 through 9.
@param {string[]} powers The characters denoting powers of 10, i.e. 1, 10, 100, 1000.
@return {CalendarsDigits} The substitution function.
@example digits: $.calendars.substituteChineseDigits(
['〇', '一', '二', '三', '四', '五', '六', '七', '八', '九'], ['', '十', '百', '千']) */
substituteChineseDigits: function(digits, powers) {
return function(value) {
var localNumber = '';
var power = 0;
while (value > 0) {
var units = value % 10;
localNumber = (units === 0 ? '' : digits[units] + powers[power]) + localNumber;
power++;
value = Math.floor(value / 10);
}
if (localNumber.indexOf(digits[1] + powers[1]) === 0) {
localNumber = localNumber.substr(1);
}
return localNumber || digits[0];
};
}
});
/** Generic date, based on a particular calendar.
@class CDate
@param {BaseCalendar} calendar The underlying calendar implementation.
@param {number} year The year for this date.
@param {number} month The month for this date.
@param {number} day The day for this date.
@return {CDate} The date object.
@throws Error if an invalid date. */
function CDate(calendar, year, month, day) {
this._calendar = calendar;
this._year = year;
this._month = month;
this._day = day;
if (this._calendar._validateLevel === 0 &&
!this._calendar.isValid(this._year, this._month, this._day)) {
throw ($.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate).
replace(/\{0\}/, this._calendar.local.name);
}
}
/** Pad a numeric value with leading zeroes.
@private
@param {number} value The number to format.
@param {number} length The minimum length.
@return {string} The formatted number. */
function pad(value, length) {
value = '' + value;
return '000000'.substring(0, length - value.length) + value;
}
$.extend(CDate.prototype, {
/** Create a new date.
@memberof CDate
@param {CDate|number} [year] The date to copy or the year for the date (default to this date).
@param {number} [month] The month for the date (if numeric year specified above).
@param {number} [day] The day for the date (if numeric year specified above).
@return {CDate} The new date.
@throws Error if an invalid date.
@example date.newDate()
date.newDate(otherDate)
date.newDate(2001, 1, 1) */
newDate: function(year, month, day) {
return this._calendar.newDate((typeof year === 'undefined' || year === null ? this : year), month, day);
},
/** Set or retrieve the year for this date.
@memberof CDate
@param {number} [year] The year for the date.
@return {number|CDate} The date's year (if no parameter) or the updated date.
@throws Error if an invalid date.
@example date.year(2001)
var year = date.year() */
year: function(year) {
return (arguments.length === 0 ? this._year : this.set(year, 'y'));
},
/** Set or retrieve the month for this date.
@memberof CDate
@param {number} [month] The month for the date.
@return {number|CDate} The date's month (if no parameter) or the updated date.
@throws Error if an invalid date.
@example date.month(1)
var month = date.month() */
month: function(month) {
return (arguments.length === 0 ? this._month : this.set(month, 'm'));
},
/** Set or retrieve the day for this date.
@memberof CDate
@param {number} [day] The day for the date.
@return {number|CData} The date's day (if no parameter) or the updated date.
@throws Error if an invalid date.
@example date.day(1)
var day = date.day() */
day: function(day) {
return (arguments.length === 0 ? this._day : this.set(day, 'd'));
},
/** Set new values for this date.
@memberof CDate
@param {number} year The year for the date.
@param {number} month The month for the date.
@param {number} day The day for the date.
@return {CDate} The updated date.
@throws Error if an invalid date.
@example date.date(2001, 1, 1) */
date: function(year, month, day) {
if (!this._calendar.isValid(year, month, day)) {
throw ($.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate).
replace(/\{0\}/, this._calendar.local.name);
}
this._year = year;
this._month = month;
this._day = day;
return this;
},
/** Determine whether this date is in a leap year.
@memberof CDate
@return {boolean} true if this is a leap year, false if not.
@example if (date.leapYear()) ...*/
leapYear: function() {
return this._calendar.leapYear(this);
},
/** Retrieve the epoch designator for this date, e.g. BCE or CE.
@memberof CDate
@return {string} The current epoch.
@example var epoch = date.epoch() */
epoch: function() {
return this._calendar.epoch(this);
},
/** Format the year, if not a simple sequential number.
@memberof CDate
@return {string} The formatted year.
@example var year = date.formatYear() */
formatYear: function() {
return this._calendar.formatYear(this);
},
/** Retrieve the month of the year for this date,
i.e. the month's position within a numbered year.
@memberof CDate
@return {number} The month of the year: minMonth to months per year.
@example var month = date.monthOfYear() */
monthOfYear: function() {
return this._calendar.monthOfYear(this);
},
/** Retrieve the week of the year for this date.
@memberof CDate
@return {number} The week of the year: 1 to weeks per year.
@example var week = date.weekOfYear() */
weekOfYear: function() {
return this._calendar.weekOfYear(this);
},
/** Retrieve the number of days in the year for this date.
@memberof CDate
@return {number} The number of days in this year.
@example var days = date.daysInYear() */
daysInYear: function() {
return this._calendar.daysInYear(this);
},
/** Retrieve the day of the year for this date.
@memberof CDate
@return {number} The day of the year: 1 to days per year.
@example var doy = date.dayOfYear() */
dayOfYear: function() {
return this._calendar.dayOfYear(this);
},
/** Retrieve the number of days in the month for this date.
@memberof CDate
@return {number} The number of days.
@example var days = date.daysInMonth() */
daysInMonth: function() {
return this._calendar.daysInMonth(this);
},
/** Retrieve the day of the week for this date.
@memberof CDate
@return {number} The day of the week: 0 to number of days - 1.
@example var dow = date.dayOfWeek() */
dayOfWeek: function() {
return this._calendar.dayOfWeek(this);
},
/** Determine whether this date is a week day.
@memberof CDate
@return {boolean} true if a week day, false if not.
@example if (date.weekDay()) ... */
weekDay: function() {
return this._calendar.weekDay(this);
},
/** Retrieve additional information about this date.
@memberof CDate
@return {object} Additional information - contents depends on calendar.
@example var info = date.extraInfo() */
extraInfo: function() {
return this._calendar.extraInfo(this);
},
/** Add period(s) to a date.
@memberof CDate
@param {number} offset The number of periods to adjust by.
@param {string} period One of 'y' for years, 'm' for months, 'w' for weeks, 'd' for days.
@return {CDate} The updated date.
@example date.add(10, 'd') */
add: function(offset, period) {
return this._calendar.add(this, offset, period);
},
/** Set a portion of the date.
@memberof CDate
@param {number} value The new value for the period.
@param {string} period One of 'y' for year, 'm' for month, 'd' for day.
@return {CDate} The updated date.
@throws Error if not a valid date.
@example date.set(10, 'd') */
set: function(value, period) {
return this._calendar.set(this, value, period);
},
/** Compare this date to another date.
@memberof CDate
@param {CDate} date The other date.
@return {number} -1 if this date is before the other date,
0 if they are equal, or +1 if this date is after the other date.
@example if (date1.compareTo(date2) < 0) ... */
compareTo: function(date) {
if (this._calendar.name !== date._calendar.name) {
throw ($.calendars.local.differentCalendars || $.calendars.regionalOptions[''].differentCalendars).
replace(/\{0\}/, this._calendar.local.name).replace(/\{1\}/, date._calendar.local.name);
}
var c = (this._year !== date._year ? this._year - date._year :
this._month !== date._month ? this.monthOfYear() - date.monthOfYear() :
this._day - date._day);
return (c === 0 ? 0 : (c < 0 ? -1 : +1));
},
/** Retrieve the calendar backing this date.
@memberof CDate
@return {BaseCalendar} The calendar implementation.
@example var cal = date.calendar() */
calendar: function() {
return this._calendar;
},
/** Retrieve the Julian date equivalent for this date,
i.e. days since January 1, 4713 BCE Greenwich noon.
@memberof CDate
@return {number} The equivalent Julian date.
@example var jd = date.toJD() */
toJD: function() {
return this._calendar.toJD(this);
},
/** Create a new date from a Julian date.
@memberof CDate
@param {number} jd The Julian date to convert.
@return {CDate} The equivalent date.
@example var date2 = date1.fromJD(jd) */
fromJD: function(jd) {
return this._calendar.fromJD(jd);
},
/** Convert this date to a standard (Gregorian) JavaScript Date.
@memberof CDate
@return {Date} The equivalent JavaScript date.
@example var jsd = date.toJSDate() */
toJSDate: function() {
return this._calendar.toJSDate(this);
},
/** Create a new date from a standard (Gregorian) JavaScript Date.
@memberof CDate
@param {Date} jsd The JavaScript date to convert.
@return {CDate} The equivalent date.
@example var date2 = date1.fromJSDate(jsd) */
fromJSDate: function(jsd) {
return this._calendar.fromJSDate(jsd);
},
/** Convert to a string for display.
@memberof CDate
@return {string} This date as a string. */
toString: function() {
return (this.year() < 0 ? '-' : '') + pad(Math.abs(this.year()), 4) +
'-' + pad(this.month(), 2) + '-' + pad(this.day(), 2);
}
});
/** Basic functionality for all calendars.
Other calendars should extend this:
OtherCalendar.prototype = new BaseCalendar();@class BaseCalendar */ function BaseCalendar() { this.shortYearCutoff = '+10'; } $.extend(BaseCalendar.prototype, { _validateLevel: 0, // "Stack" to turn validation on/off /** Create a new date within this calendar - today if no parameters given. @memberof BaseCalendar @param {CDate|number} year The date to duplicate or the year for the date. @param {number} [month] The month for the date (if numeric
year specified above).
@param {number} [day] The day for the date (if numeric year specified above).
@return {CDate} The new date.
@throws Error if not a valid date or a different calendar is used.
@example var date = calendar.newDate(2014, 1, 26)
var date2 = calendar.newDate(date1)
var today = calendar.newDate() */
newDate: function(year, month, day) {
if (typeof year === 'undefined' || year === null) {
return this.today();
}
if (year.year) {
this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
day = year.day();
month = year.month();
year = year.year();
}
return new CDate(this, year, month, day);
},
/** Create a new date for today.
@memberof BaseCalendar
@return {CDate} Today's date.
@example var today = calendar.today() */
today: function() {
return this.fromJSDate(new Date());
},
/** Retrieve the epoch designator for this date.
@memberof BaseCalendar
@param {CDate|number} year The date to examine or the year to examine.
@return {string} The current epoch.
@throws Error if an invalid year or a different calendar is used.
@example var epoch = calendar.epoch(date)
var epoch = calendar.epoch(2014) */
epoch: function(year) {
var date = this._validate(year, this.minMonth, this.minDay,
$.calendars.local.invalidYear || $.calendars.regionalOptions[''].invalidYear);
return (date.year() < 0 ? this.local.epochs[0] : this.local.epochs[1]);
},
/** Format the year, if not a simple sequential number
@memberof BaseCalendar
@param {CDate|number} year The date to format or the year to format.
@return {string} The formatted year.
@throws Error if an invalid year or a different calendar is used.
@example var year = calendar.formatYear(date)
var year = calendar.formatYear(2014) */
formatYear: function(year) {
var date = this._validate(year, this.minMonth, this.minDay,
$.calendars.local.invalidYear || $.calendars.regionalOptions[''].invalidYear);
return (date.year() < 0 ? '-' : '') + pad(Math.abs(date.year()), 4);
},
/** Retrieve the number of months in a year.
@memberof BaseCalendar
@param {CDate|number} year The date to examine or the year to examine.
@return {number} The number of months.
@throws Error if an invalid year or a different calendar is used.
@example var months = calendar.monthsInYear(date)
var months = calendar.monthsInYear(2014) */
monthsInYear: function(year) {
this._validate(year, this.minMonth, this.minDay,
$.calendars.local.invalidYear || $.calendars.regionalOptions[''].invalidYear);
return 12;
},
/** Calculate the month's ordinal position within the year -
for those calendars that don't start at month 1!
@memberof BaseCalendar
@param {CDate|number} year The date to examine or the year to examine.
@param {number} [month] The month to examine (if numeric year specified above).
@return {number} The ordinal position, starting from minMonth.
@throws Error if an invalid year/month or a different calendar is used.
@example var pos = calendar.monthOfYear(date)
var pos = calendar.monthOfYear(2014, 7) */
monthOfYear: function(year, month) {
var date = this._validate(year, month, this.minDay,
$.calendars.local.invalidMonth || $.calendars.regionalOptions[''].invalidMonth);
return (date.month() + this.monthsInYear(date) - this.firstMonth) %
this.monthsInYear(date) + this.minMonth;
},
/** Calculate actual month from ordinal position, starting from minMonth.
@memberof BaseCalendar
@param {number} year The year to examine.
@param {number} ord The month's ordinal position.
@return {number} The month's number.
@throws Error if an invalid year/month.
@example var month = calendar.fromMonthOfYear(2014, 7) */
fromMonthOfYear: function(year, ord) {
var m = (ord + this.firstMonth - 2 * this.minMonth) %
this.monthsInYear(year) + this.minMonth;
this._validate(year, m, this.minDay,
$.calendars.local.invalidMonth || $.calendars.regionalOptions[''].invalidMonth);
return m;
},
/** Retrieve the number of days in a year.
@memberof BaseCalendar
@param {CDate|number} year The date to examine or the year to examine.
@return {number} The number of days.
@throws Error if an invalid year or a different calendar is used.
@example var days = calendar.daysInYear(date)
var days = calendar.daysInYear(2014) */
daysInYear: function(year) {
var date = this._validate(year, this.minMonth, this.minDay,
$.calendars.local.invalidYear || $.calendars.regionalOptions[''].invalidYear);
return (this.leapYear(date) ? 366 : 365);
},
/** Retrieve the day of the year for a date.
@memberof BaseCalendar
@param {CDate|number} year The date to convert or the year to convert.
@param {number} [month] The month to convert (if numeric year specified above).
@param {number} [day] The day to convert (if numeric year specified above).
@return {number} The day of the year: 1 to days per year.
@throws Error if an invalid date or a different calendar is used.
@example var doy = calendar.dayOfYear(date)
var doy = calendar.dayOfYear(2014, 7, 1) */
dayOfYear: function(year, month, day) {
var date = this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
return date.toJD() - this.newDate(date.year(),
this.fromMonthOfYear(date.year(), this.minMonth), this.minDay).toJD() + 1;
},
/** Retrieve the number of days in a week.
@memberof BaseCalendar
@return {number} The number of days.
@example var days = calendar.daysInWeek() */
daysInWeek: function() {
return 7;
},
/** Retrieve the day of the week for a date.
@memberof BaseCalendar
@param {CDate|number} year The date to examine or the year to examine.
@param {number} [month] The month to examine (if numeric year specified above).
@param {number} [day] The day to examine (if numeric year specified above).
@return {number} The day of the week: 0 to number of days - 1.
@throws Error if an invalid date or a different calendar is used.
@example var dow = calendar.dayOfWeek(date)
var dow = calendar.dayOfWeek(2014, 1, 26) */
dayOfWeek: function(year, month, day) {
var date = this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
return (Math.floor(this.toJD(date)) + 2) % this.daysInWeek();
},
/** Retrieve additional information about a date.
@memberof BaseCalendar
@param {CDate|number} year The date to examine or the year to examine.
@param {number} [month] The month to examine (if numeric year specified above).
@param {number} [day] The day to examine (if numeric year specified above).
@return {object} Additional information - content depends on calendar.
@throws Error if an invalid date or a different calendar is used.
@example var info = calendar.extraInfo(date)
var info = calendar.extraInfo(2014, 1, 26) */
extraInfo: function(year, month, day) {
this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
return {};
},
/** Add period(s) to a date.
Cater for no year zero.
@memberof BaseCalendar
@param {CDate} date The starting date.
@param {number} offset The number of periods to adjust by.
@param {string} period One of 'y' for years, 'm' for months, 'w' for weeks, 'd' for days.
@return {CDate} The updated date.
@throws Error if a different calendar is used.
@example calendar.add(date, 10, 'd') */
add: function(date, offset, period) {
this._validate(date, this.minMonth, this.minDay,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
return this._correctAdd(date, this._add(date, offset, period), offset, period);
},
/** Add period(s) to a date.
@memberof BaseCalendar
@private
@param {CDate} date The starting date.
@param {number} offset The number of periods to adjust by.
@param {string} period One of 'y' for years, 'm' for months, 'w' for weeks, 'd' for days.
@return {number[]} The updated date as year, month, and day. */
_add: function(date, offset, period) {
this._validateLevel++;
var d;
if (period === 'd' || period === 'w') {
var jd = date.toJD() + offset * (period === 'w' ? this.daysInWeek() : 1);
d = date.calendar().fromJD(jd);
this._validateLevel--;
return [d.year(), d.month(), d.day()];
}
try {
var y = date.year() + (period === 'y' ? offset : 0);
var m = date.monthOfYear() + (period === 'm' ? offset : 0);
d = date.day();
var resyncYearMonth = function(calendar) {
while (m < calendar.minMonth) {
y--;
m += calendar.monthsInYear(y);
}
var yearMonths = calendar.monthsInYear(y);
while (m > yearMonths - 1 + calendar.minMonth) {
y++;
m -= yearMonths;
yearMonths = calendar.monthsInYear(y);
}
};
if (period === 'y') {
if (date.month() !== this.fromMonthOfYear(y, m)) { // Hebrew
m = this.newDate(y, date.month(), this.minDay).monthOfYear();
}
m = Math.min(m, this.monthsInYear(y));
d = Math.min(d, this.daysInMonth(y, this.fromMonthOfYear(y, m)));
}
else if (period === 'm') {
resyncYearMonth(this);
d = Math.min(d, this.daysInMonth(y, this.fromMonthOfYear(y, m)));
}
var ymd = [y, this.fromMonthOfYear(y, m), d];
this._validateLevel--;
return ymd;
}
catch (e) {
this._validateLevel--;
throw e;
}
},
/** Correct a candidate date after adding period(s) to a date.
Handle no year zero if necessary.
@memberof BaseCalendar
@private
@param {CDate} date The starting date.
@param {number[]} ymd The added date.
@param {number} offset The number of periods to adjust by.
@param {string} period One of 'y' for years, 'm' for months, 'w' for weeks, 'd' for days.
@return {CDate} The updated date. */
_correctAdd: function(date, ymd, offset, period) {
if (!this.hasYearZero && (period === 'y' || period === 'm')) {
if (ymd[0] === 0 || // In year zero
(date.year() > 0) !== (ymd[0] > 0)) { // Crossed year zero
var adj = {y: [1, 1, 'y'], m: [1, this.monthsInYear(-1), 'm'],
w: [this.daysInWeek(), this.daysInYear(-1), 'd'],
d: [1, this.daysInYear(-1), 'd']}[period];
var dir = (offset < 0 ? -1 : +1);
ymd = this._add(date, offset * adj[0] + dir * adj[1], adj[2]);
}
}
return date.date(ymd[0], ymd[1], ymd[2]);
},
/** Set a portion of the date.
@memberof BaseCalendar
@param {CDate} date The starting date.
@param {number} value The new value for the period.
@param {string} period One of 'y' for year, 'm' for month, 'd' for day.
@return {CDate} The updated date.
@throws Error if an invalid date or a different calendar is used.
@example calendar.set(date, 10, 'd') */
set: function(date, value, period) {
this._validate(date, this.minMonth, this.minDay,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
var y = (period === 'y' ? value : date.year());
var m = (period === 'm' ? value : date.month());
var d = (period === 'd' ? value : date.day());
if (period === 'y' || period === 'm') {
d = Math.min(d, this.daysInMonth(y, m));
}
return date.date(y, m, d);
},
/** Determine whether a date is valid for this calendar.
@memberof BaseCalendar
@param {number} year The year to examine.
@param {number} month The month to examine.
@param {number} day The day to examine.
@return {boolean} true if a valid date, false if not.
@example if (calendar.isValid(2014, 2, 31)) ... */
isValid: function(year, month, day) {
this._validateLevel++;
var valid = (this.hasYearZero || year !== 0);
if (valid) {
var date = this.newDate(year, month, this.minDay);
valid = (month >= this.minMonth && month - this.minMonth < this.monthsInYear(date)) &&
(day >= this.minDay && day - this.minDay < this.daysInMonth(date));
}
this._validateLevel--;
return valid;
},
/** Convert the date to a standard (Gregorian) JavaScript Date.
@memberof BaseCalendar
@param {CDate|number} year The date to convert or the year to convert.
@param {number} [month] The month to convert (if numeric year specified above).
@param {number} [day] The day to convert (if numeric year specified above).
@return {Date} The equivalent JavaScript date.
@throws Error if an invalid date or a different calendar is used.
@example var jsd = calendar.toJSDate(date)
var jsd = calendar.toJSDate(2014, 1, 26) */
toJSDate: function(year, month, day) {
var date = this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
return $.calendars.instance().fromJD(this.toJD(date)).toJSDate();
},
/** Convert the date from a standard (Gregorian) JavaScript Date.
@memberof BaseCalendar
@param {Date} jsd The JavaScript date.
@return {CDate} The equivalent calendar date.
@example var date = calendar.fromJSDate(jsd) */
fromJSDate: function(jsd) {
return this.fromJD($.calendars.instance().fromJSDate(jsd).toJD());
},
/** Check that a candidate date is from the same calendar and is valid.
@memberof BaseCalendar
@private
@param {CDate|number} year The date to validate or the year to validate.
@param {number} [month] The month to validate (if numeric year specified above).
@param {number} [day] The day to validate (if numeric year specified above).
@param {string} error Error message if invalid.
@throws Error if an invalid date or a different calendar is used. */
_validate: function(year, month, day, error) {
if (year.year) {
if (this._validateLevel === 0 && this.name !== year.calendar().name) {
throw ($.calendars.local.differentCalendars || $.calendars.regionalOptions[''].differentCalendars).
replace(/\{0\}/, this.local.name).replace(/\{1\}/, year.calendar().local.name);
}
return year;
}
try {
this._validateLevel++;
if (this._validateLevel === 1 && !this.isValid(year, month, day)) {
throw error.replace(/\{0\}/, this.local.name);
}
var date = this.newDate(year, month, day);
this._validateLevel--;
return date;
}
catch (e) {
this._validateLevel--;
throw e;
}
}
});
/** Implementation of the Proleptic Gregorian Calendar.
See http://en.wikipedia.org/wiki/Gregorian_calendar
and http://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar.
@class GregorianCalendar
@augments BaseCalendar
@param {string} [language=''] The language code (default English) for localisation. */
function GregorianCalendar(language) {
this.local = this.regionalOptions[language] || this.regionalOptions[''];
}
GregorianCalendar.prototype = new BaseCalendar();
$.extend(GregorianCalendar.prototype, {
/** The calendar name.
@memberof GregorianCalendar */
name: 'Gregorian',
/** Julian date of start of Gregorian epoch: 1 January 0001 CE.
@memberof GregorianCalendar */
jdEpoch: 1721425.5,
/** Days per month in a common year.
@memberof GregorianCalendar */
daysPerMonth: [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31],
/** true if has a year zero, false if not.
@memberof GregorianCalendar */
hasYearZero: false,
/** The minimum month number.
@memberof GregorianCalendar */
minMonth: 1,
/** The first month in the year.
@memberof GregorianCalendar */
firstMonth: 1,
/** The minimum day number.
@memberof GregorianCalendar */
minDay: 1,
/** Convert a number into a localised form.
@callback CalendarsDigits
@param {number} value The number to convert.
@return {string} The localised number.
@example digits: $.calendars.substituteDigits(['۰', '۱', '۲', '۳', '۴', '۵', '۶', '۷', '۸', '۹']) */
/** Localisations for the plugin.
Entries are objects indexed by the language code ('' being the default US/English).
Each object has the following attributes.
@memberof GregorianCalendar
@property {string} [name='Gregorian'] The calendar name.
@property {string[]} [epochs=['BCE','CE']] The epoch names.
@property {string[]} [monthNames=[...]] The long names of the months of the year.
@property {string[]} [monthNamesShort=[...]] The short names of the months of the year.
@property {string[]} [dayNames=[...]] The long names of the days of the week.
@property {string[]} [dayNamesShort=[...]] The short names of the days of the week.
@property {string[]} [dayNamesMin=[...]] The minimal names of the days of the week.
@property {CalendarsDigits} [digits=null] Convert numbers to localised versions.
@property {string} [dateFormat='mm/dd/yyyy'] The date format for this calendar.
See the options on {@linkcode BaseCalendar.formatDate|formatDate} for details.
@property {number} [firstDay=0] The number of the first day of the week, starting at 0.
@property {boolean} [isRTL=false] true if this localisation reads right-to-left. */
regionalOptions: { // Localisations
'': {
name: 'Gregorian',
epochs: ['BCE', 'CE'],
monthNames: ['January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November', 'December'],
monthNamesShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
dayNames: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
dayNamesShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
dayNamesMin: ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'],
digits: null,
dateFormat: 'mm/dd/yyyy',
firstDay: 0,
isRTL: false
}
},
/** Determine whether this date is in a leap year.
@memberof GregorianCalendar
@param {CDate|number} year The date to examine or the year to examine.
@return {boolean} true if this is a leap year, false if not.
@throws Error if an invalid year or a different calendar is used. */
leapYear: function(year) {
var date = this._validate(year, this.minMonth, this.minDay,
$.calendars.local.invalidYear || $.calendars.regionalOptions[''].invalidYear);
year = date.year() + (date.year() < 0 ? 1 : 0); // No year zero
return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
},
/** Determine the week of the year for a date - ISO 8601.
@memberof GregorianCalendar
@param {CDate|number} year The date to examine or the year to examine.
@param {number} [month] The month to examine (if numeric year specified above).
@param {number} [day] The day to examine (if numeric year specified above).
@return {number} The week of the year, starting from 1.
@throws Error if an invalid date or a different calendar is used. */
weekOfYear: function(year, month, day) {
// Find Thursday of this week starting on Monday
var checkDate = this.newDate(year, month, day);
checkDate.add(4 - (checkDate.dayOfWeek() || 7), 'd');
return Math.floor((checkDate.dayOfYear() - 1) / 7) + 1;
},
/** Retrieve the number of days in a month.
@memberof GregorianCalendar
@param {CDate|number} year The date to examine or the year of the month.
@param {number} [month] The month (if numeric year specified above).
@return {number} The number of days in this month.
@throws Error if an invalid month/year or a different calendar is used. */
daysInMonth: function(year, month) {
var date = this._validate(year, month, this.minDay,
$.calendars.local.invalidMonth || $.calendars.regionalOptions[''].invalidMonth);
return this.daysPerMonth[date.month() - 1] +
(date.month() === 2 && this.leapYear(date.year()) ? 1 : 0);
},
/** Determine whether this date is a week day.
@memberof GregorianCalendar
@param {CDate|number} year The date to examine or the year to examine.
@param {number} [month] The month to examine (if numeric year specified above).
@param {number} [day] The day to examine (if numeric year specified above).
@return {boolean} true if a week day, false if not.
@throws Error if an invalid date or a different calendar is used. */
weekDay: function(year, month, day) {
return (this.dayOfWeek(year, month, day) || 7) < 6;
},
/** Retrieve the Julian date equivalent for this date,
i.e. days since January 1, 4713 BCE Greenwich noon.
@memberof GregorianCalendar
@param {CDate|number} year The date to convert or the year to convert.
@param {number} [month] The month to convert (if numeric year specified above).
@param {number} [day] The day to convert (if numeric year specified above).
@return {number} The equivalent Julian date.
@throws Error if an invalid date or a different calendar is used. */
toJD: function(year, month, day) {
var date = this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
year = date.year();
month = date.month();
day = date.day();
if (year < 0) { year++; } // No year zero
// Jean Meeus algorithm, "Astronomical Algorithms", 1991
if (month < 3) {
month += 12;
year--;
}
var a = Math.floor(year / 100);
var b = 2 - a + Math.floor(a / 4);
return Math.floor(365.25 * (year + 4716)) +
Math.floor(30.6001 * (month + 1)) + day + b - 1524.5;
},
/** Create a new date from a Julian date.
@memberof GregorianCalendar
@param {number} jd The Julian date to convert.
@return {CDate} The equivalent date. */
fromJD: function(jd) {
// Jean Meeus algorithm, "Astronomical Algorithms", 1991
var z = Math.floor(jd + 0.5);
var a = Math.floor((z - 1867216.25) / 36524.25);
a = z + 1 + a - Math.floor(a / 4);
var b = a + 1524;
var c = Math.floor((b - 122.1) / 365.25);
var d = Math.floor(365.25 * c);
var e = Math.floor((b - d) / 30.6001);
var day = b - d - Math.floor(e * 30.6001);
var month = e - (e > 13.5 ? 13 : 1);
var year = c - (month > 2.5 ? 4716 : 4715);
if (year <= 0) { year--; } // No year zero
return this.newDate(year, month, day);
},
/** Convert this date to a standard (Gregorian) JavaScript Date.
@memberof GregorianCalendar
@param {CDate|number} year The date to convert or the year to convert.
@param {number} [month] The month to convert (if numeric year specified above).
@param {number} [day] The day to convert (if numeric year specified above).
@return {Date} The equivalent JavaScript date.
@throws Error if an invalid date or a different calendar is used. */
toJSDate: function(year, month, day) {
var date = this._validate(year, month, day,
$.calendars.local.invalidDate || $.calendars.regionalOptions[''].invalidDate);
var jsd = new Date(date.year(), date.month() - 1, date.day());
jsd.setHours(0);
jsd.setMinutes(0);
jsd.setSeconds(0);
jsd.setMilliseconds(0);
// Hours may be non-zero on daylight saving cut-over:
// > 12 when midnight changeover, but then cannot generate
// midnight datetime, so jump to 1AM, otherwise reset.
jsd.setHours(jsd.getHours() > 12 ? jsd.getHours() + 2 : 0);
return jsd;
},
/** Create a new date from a standard (Gregorian) JavaScript Date.
@memberof GregorianCalendar
@param {Date} jsd The JavaScript date to convert.
@return {CDate} The equivalent date. */
fromJSDate: function(jsd) {
return this.newDate(jsd.getFullYear(), jsd.getMonth() + 1, jsd.getDate());
}
});
// Singleton manager
$.calendars = new Calendars();
// Date template
$.calendars.cdate = CDate;
// Base calendar template
$.calendars.baseCalendar = BaseCalendar;
// Gregorian calendar implementation
$.calendars.calendars.gregorian = GregorianCalendar;
})(jQuery);
/* http://keith-wood.name/calendars.html
Calendars extras for jQuery v2.1.0.
Written by Keith Wood (wood.keith{at}optusnet.com.au) August 2009.
Available under the MIT (http://keith-wood.name/licence.html) license.
Please attribute the author if you use it. */
(function($) { // Hide scope, no $ conflict
'use strict';
$.extend($.calendars.regionalOptions[''], {
invalidArguments: 'Invalid arguments',
invalidFormat: 'Cannot format a date from another calendar',
missingNumberAt: 'Missing number at position {0}',
unknownNameAt: 'Unknown name at position {0}',
unexpectedLiteralAt: 'Unexpected literal at position {0}',
unexpectedText: 'Additional text found at end'
});
$.calendars.local = $.calendars.regionalOptions[''];
$.extend($.calendars.cdate.prototype, {
/** Format this date.
Found in the jquery.calendars.plus.js module.
@memberof CDate
@param {string} [format] The date format to use (see {@linkcode BaseCalendar.formatDate|formatDate}).
@param {object} [settings] Options for the formatDate function.
@return {string} The formatted date. */
formatDate: function(format, settings) {
if (typeof format !== 'string') {
settings = format;
format = '';
}
return this._calendar.formatDate(format || '', this, settings);
}
});
$.extend($.calendars.baseCalendar.prototype, {
UNIX_EPOCH: $.calendars.instance().newDate(1970, 1, 1).toJD(),
SECS_PER_DAY: 24 * 60 * 60,
TICKS_EPOCH: $.calendars.instance().jdEpoch, // 1 January 0001 CE
TICKS_PER_DAY: 24 * 60 * 60 * 10000000,
/** Date format for ATOM (RFC 3339/ISO 8601) - 'yyyy-mm-dd'.
@memberof BaseCalendar */
ATOM: 'yyyy-mm-dd',
/** Date format for cookies - 'D, dd M yyyy'.
@memberof BaseCalendar */
COOKIE: 'D, dd M yyyy',
/** Date format for the full date - 'DD, MM d, yyyy'.
@memberof BaseCalendar */
FULL: 'DD, MM d, yyyy',
/** Date format for ISO 8601 - 'yyyy-mm-dd'.
@memberof BaseCalendar */
ISO_8601: 'yyyy-mm-dd',
/** Date format for Julian date - days since January 1, 4713 BCE Greenwich noon.
@memberof BaseCalendar */
JULIAN: 'J',
/** Date format for RFC 822 - 'D, d M yy'.
@memberof BaseCalendar */
RFC_822: 'D, d M yy',
/** Date format for RFC 850 - 'DD, dd-M-yy'.
@memberof BaseCalendar */
RFC_850: 'DD, dd-M-yy',
/** Date format for RFC 1036 - 'D, d M yy'.
@memberof BaseCalendar */
RFC_1036: 'D, d M yy',
/** Date format for RFC 1123 - 'D, d M yyyy'.
@memberof BaseCalendar */
RFC_1123: 'D, d M yyyy',
/** Date format for RFC 2822 - 'D, d M yyyy'.
@memberof BaseCalendar */
RFC_2822: 'D, d M yyyy',
/** Date format for RSS (RFC 822) - 'D, d M yy'.
@memberof BaseCalendar */
RSS: 'D, d M yy',
/** Date format for Windows ticks - number of 100-nanosecond ticks since 1 January 0001 00:00:00 UTC.
@memberof BaseCalendar */
TICKS: '!',
/** Date format for Unix timestamp - number of seconds elapsed since the
start of the Unix epoch at 1 January 1970 00:00:00 UTC.
@memberof BaseCalendar */
TIMESTAMP: '@',
/** Date format for W3C (ISO 8601) - 'yyyy-mm-dd'.
@memberof BaseCalendar */
W3C: 'yyyy-mm-dd',
/** Format a date object into a string value.
The format can be combinations of the following:
jquery.calendars.plus.js module.
@memberof BaseCalendar
@param {string} [format] The desired format of the date (defaults to calendar format).
@param {CDate} date The date value to format.
@param {object} [settings] Addition options, whose attributes include:
@param {string[]} [settings.dayNamesShort] Abbreviated names of the days from day 0 (Sunday).
@param {string[]} [settings.dayNames] Names of the days from day 0 (Sunday).
@param {string[]} [settings.monthNamesShort] Abbreviated names of the months.
@param {string[]} [settings.monthNames] Names of the months.
@param {boolean} [settings.localNumbers=false] true to localise numbers (if available),
false to use normal Arabic numerals.
@return {string} The date in the above format.
@throws Errors if the date is from a different calendar. */
formatDate: function(format, date, settings) {
if (typeof format !== 'string') {
settings = date;
date = format;
format = '';
}
if (!date) {
return '';
}
if (date.calendar() !== this) {
throw $.calendars.local.invalidFormat || $.calendars.regionalOptions[''].invalidFormat;
}
format = format || this.local.dateFormat;
settings = settings || {};
var dayNamesShort = settings.dayNamesShort || this.local.dayNamesShort;
var dayNames = settings.dayNames || this.local.dayNames;
var monthNamesShort = settings.monthNamesShort || this.local.monthNamesShort;
var monthNames = settings.monthNames || this.local.monthNames;
var localNumbers = settings.localNumbers || this.local.localNumbers;
// Check whether a format character is doubled
var doubled = function(match, step) {
var matches = 1;
while (iFormat + matches < format.length && format.charAt(iFormat + matches) === match) {
matches++;
}
iFormat += matches - 1;
return Math.floor(matches / (step || 1)) > 1;
};
// Format a number, with leading zeroes if necessary
var formatNumber = function(match, value, len, step) {
var num = '' + value;
if (doubled(match, step)) {
while (num.length < len) {
num = '0' + num;
}
}
return num;
};
// Format a name, short or long as requested
var formatName = function(match, value, shortNames, longNames) {
return (doubled(match) ? longNames[value] : shortNames[value]);
};
// Localise numbers if requested and available
var localiseNumbers = localNumbers && this.local.digits ?
this.local.digits : function(value) { return value; };
var output = '';
var literal = false;
for (var iFormat = 0; iFormat < format.length; iFormat++) {
if (literal) {
if (format.charAt(iFormat) === '\'' && !doubled('\'')) {
literal = false;
}
else {
output += format.charAt(iFormat);
}
}
else {
switch (format.charAt(iFormat)) {
case 'd':
output += localiseNumbers(formatNumber('d', date.day(), 2));
break;
case 'D':
output += formatName('D', date.dayOfWeek(), dayNamesShort, dayNames);
break;
case 'o':
output += formatNumber('o', date.dayOfYear(), 3);
break;
case 'w':
output += formatNumber('w', date.weekOfYear(), 2);
break;
case 'm':
output += localiseNumbers(formatNumber('m', date.month(), 2));
break;
case 'M':
output += formatName('M', date.month() - this.minMonth, monthNamesShort, monthNames);
break;
case 'y':
output += localiseNumbers(doubled('y', 2) ? date.year() :
(date.year() % 100 < 10 ? '0' : '') + date.year() % 100);
break;
case 'Y':
doubled('Y', 2);
output += date.formatYear();
break;
case 'J':
output += date.toJD();
break;
case '@':
output += (date.toJD() - this.UNIX_EPOCH) * this.SECS_PER_DAY;
break;
case '!':
output += (date.toJD() - this.TICKS_EPOCH) * this.TICKS_PER_DAY;
break;
case '\'':
if (doubled('\'')) {
output += '\'';
}
else {
literal = true;
}
break;
default:
output += format.charAt(iFormat);
}
}
}
return output;
},
/** Parse a string value into a date object.
See {@linkcode BaseCalendar.formatDate|formatDate} for the possible formats, plus:
jquery.calendars.plus.js module.
@memberof BaseCalendar
@param {string} format The expected format of the date ('' for default calendar format).
@param {string} value The date in the above format.
@param {object} [settings] Additional options whose attributes include:
@param {number} [settings.shortYearCutoff] The cutoff year for determining the century.
@param {string[]} [settings.dayNamesShort] Abbreviated names of the days from day 0 (Sunday).
@param {string[]} [settings.dayNames] Names of the days from day 0 (Sunday).
@param {string[]} [settings.monthNamesShort] Abbreviated names of the months.
@param {string[]} [settings.monthNames] Names of the months.
@return {CDate} The extracted date value or null if value is blank.
@throws Errors if the format and/or value are missing,
if the value doesn't match the format, or if the date is invalid. */
parseDate: function(format, value, settings) {
if (typeof value === 'undefined' || value === null) {
throw $.calendars.local.invalidArguments || $.calendars.regionalOptions[''].invalidArguments;
}
value = (typeof value === 'object' ? value.toString() : value + '');
if (value === '') {
return null;
}
format = format || this.local.dateFormat;
settings = settings || {};
var shortYearCutoff = settings.shortYearCutoff || this.shortYearCutoff;
shortYearCutoff = (typeof shortYearCutoff !== 'string' ? shortYearCutoff :
this.today().year() % 100 + parseInt(shortYearCutoff, 10));
var dayNamesShort = settings.dayNamesShort || this.local.dayNamesShort;
var dayNames = settings.dayNames || this.local.dayNames;
var monthNamesShort = settings.monthNamesShort || this.local.monthNamesShort;
var monthNames = settings.monthNames || this.local.monthNames;
var jd = -1;
var year = -1;
var month = -1;
var day = -1;
var doy = -1;
var shortYear = false;
var literal = false;
// Check whether a format character is doubled
var doubled = function(match, step) {
var matches = 1;
while (iFormat + matches < format.length && format.charAt(iFormat + matches) === match) {
matches++;
}
iFormat += matches - 1;
return Math.floor(matches / (step || 1)) > 1;
};
// Extract a number from the string value
var getNumber = function(match, step) {
var isDoubled = doubled(match, step);
var size = [2, 3, isDoubled ? 4 : 2, isDoubled ? 4 : 2, 10, 11, 20]['oyYJ@!'.indexOf(match) + 1];
var digits = new RegExp('^-?\\d{1,' + size + '}');
var num = value.substring(iValue).match(digits);
if (!num) {
throw ($.calendars.local.missingNumberAt || $.calendars.regionalOptions[''].missingNumberAt).
replace(/\{0\}/, iValue);
}
iValue += num[0].length;
return parseInt(num[0], 10);
};
// Extract a name from the string value and convert to an index
var calendar = this;
var getName = function(match, shortNames, longNames, step) {
var names = (doubled(match, step) ? longNames : shortNames);
for (var i = 0; i < names.length; i++) {
if (value.substr(iValue, names[i].length).toLowerCase() === names[i].toLowerCase()) {
iValue += names[i].length;
return i + calendar.minMonth;
}
}
throw ($.calendars.local.unknownNameAt || $.calendars.regionalOptions[''].unknownNameAt).
replace(/\{0\}/, iValue);
};
// Confirm that a literal character matches the string value
var checkLiteral = function() {
if (value.charAt(iValue) !== format.charAt(iFormat)) {
throw ($.calendars.local.unexpectedLiteralAt ||
$.calendars.regionalOptions[''].unexpectedLiteralAt).replace(/\{0\}/, iValue);
}
iValue++;
};
var iValue = 0;
for (var iFormat = 0; iFormat < format.length; iFormat++) {
if (literal) {
if (format.charAt(iFormat) === '\'' && !doubled('\'')) {
literal = false;
}
else {
checkLiteral();
}
}
else {
switch (format.charAt(iFormat)) {
case 'd':
day = getNumber('d');
break;
case 'D':
getName('D', dayNamesShort, dayNames);
break;
case 'o':
doy = getNumber('o');
break;
case 'w':
getNumber('w');
break;
case 'm':
month = getNumber('m');
break;
case 'M':
month = getName('M', monthNamesShort, monthNames);
break;
case 'y':
var iSave = iFormat;
shortYear = !doubled('y', 2);
iFormat = iSave;
year = getNumber('y', 2);
break;
case 'Y':
year = getNumber('Y', 2);
break;
case 'J':
jd = getNumber('J') + 0.5;
if (value.charAt(iValue) === '.') {
iValue++;
getNumber('J');
}
break;
case '@':
jd = getNumber('@') / this.SECS_PER_DAY + this.UNIX_EPOCH;
break;
case '!':
jd = getNumber('!') / this.TICKS_PER_DAY + this.TICKS_EPOCH;
break;
case '*':
iValue = value.length;
break;
case '\'':
if (doubled('\'')) {
checkLiteral();
}
else {
literal = true;
}
break;
default:
checkLiteral();
}
}
}
if (iValue < value.length) {
throw $.calendars.local.unexpectedText || $.calendars.regionalOptions[''].unexpectedText;
}
if (year === -1) {
year = this.today().year();
}
else if (year < 100 && shortYear) {
year += (shortYearCutoff === -1 ? 1900 : this.today().year() -
this.today().year() % 100 - (year <= shortYearCutoff ? 0 : 100));
}
if (doy > -1) {
month = 1;
day = doy;
for (var dim = this.daysInMonth(year, month); day > dim; dim = this.daysInMonth(year, month)) {
month++;
day -= dim;
}
}
return (jd > -1 ? this.fromJD(jd) : this.newDate(year, month, day));
},
/** A date may be specified as an exact value or a relative one.
Found in the jquery.calendars.plus.js module.
@memberof BaseCalendar
@param {CDate|number|string} dateSpec The date as an object or string in the given format or
an offset - numeric days from today, or string amounts and periods, e.g. '+1m +2w'.
@param {CDate} defaultDate The date to use if no other supplied, may be null.
@param {CDate} [currentDate=null] The current date as a possible basis for relative dates,
if null today is used.
@param {string} [dateFormat] The expected date format -
see {@linkcode BaseCalendar.formatDate|formatDate}. Use '' for the calendar default format.
@param {object} [settings] Additional options whose attributes include:
@param {number} [settings.shortYearCutoff] The cutoff year for determining the century.
@param {string[]} [settings.dayNamesShort] Abbreviated names of the days from day 0 (Sunday).
@param {string[]} [settings.dayNames] Names of the days from day 0 (Sunday).
@param {string[]} [settings.monthNamesShort] Abbreviated names of the months.
@param {string[]} [settings.monthNames] Names of the months.
@return {CDate} The decoded date. */
determineDate: function(dateSpec, defaultDate, currentDate, dateFormat, settings) {
if (currentDate && typeof currentDate !== 'object') {
settings = dateFormat;
dateFormat = currentDate;
currentDate = null;
}
if (typeof dateFormat !== 'string') {
settings = dateFormat;
dateFormat = '';
}
var calendar = this;
var offsetString = function(offset) {
try {
return calendar.parseDate(dateFormat, offset, settings);
}
catch (e) {
// Ignore
}
offset = offset.toLowerCase();
var date = (offset.match(/^c/) && currentDate ?
currentDate.newDate() : null) || calendar.today();
var pattern = /([+-]?[0-9]+)\s*(d|w|m|y)?/g;
var matches = pattern.exec(offset);
while (matches) {
date.add(parseInt(matches[1], 10), matches[2] || 'd');
matches = pattern.exec(offset);
}
return date;
};
defaultDate = (defaultDate ? defaultDate.newDate() : null);
dateSpec = (typeof dateSpec === 'undefined' || dateSpec === null ? defaultDate :
(typeof dateSpec === 'string' ? offsetString(dateSpec) : (typeof dateSpec === 'number' ?
(isNaN(dateSpec) || dateSpec === Infinity || dateSpec === -Infinity ? defaultDate :
calendar.today().add(dateSpec, 'd')) : calendar.newDate(dateSpec))));
return dateSpec;
}
});
})(jQuery);
/* http://keith-wood.name/calendars.html
Calendars date picker for jQuery v2.1.0.
Written by Keith Wood (wood.keith{at}optusnet.com.au) August 2009.
Available under the MIT (http://keith-wood.name/licence.html) license.
Please attribute the author if you use it. */
(function($) { // Hide scope, no $ conflict
'use strict';
var pluginName = 'calendarsPicker';
/** Create the calendars datepicker plugin.
Sets an input field to popup a calendar for date entry,
or a div or span to show an inline calendar.
Expects HTML like:
<input type="text"> or <div></div>
Provide inline configuration like:
<input type="text" data-calendarsPicker="name: 'value'"/>@class CalendarsPicker @augments JQPlugin @example $(selector).calendarsPicker() $(selector).calendarsPicker({minDate: 0, maxDate: '+1m +1w'}) */ $.JQPlugin.createPlugin({ /** The name of the plugin. @memberof CalendarsPicker @default 'calendarsPicker' */ name: pluginName, /** Default template for generating a datepicker. Insert anywhere:
monthsToStep option) - PageUpmonthsToJump option) - Ctrl+PageUpmonthsToStep option) - PageDownmonthsToJump option) - Ctrl+PageDowntrue if Ctrl is required,
@property {boolean} [keystroke.altKey] true if Alt is required,
@property {boolean} [keystroke.shiftKey] true if Shift is required.
@property {CalendarsPickerCommandEnabled} enabled The function that indicates the command is enabled.
@property {CalendarsPickerCommandDate} date The function to get the date associated with this action.
@property {CalendarsPickerCommandAction} action The function that implements the action. */
commands: {
prev: {
text: 'prevText',
status: 'prevStatus', // Previous month
keystroke: {keyCode: 33}, // Page up
enabled: function(inst) {
var minDate = inst.curMinDate();
return (!minDate || inst.drawDate.newDate().
add(1 - inst.options.monthsToStep - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay).add(-1, 'd').compareTo(minDate) !== -1);
},
date: function(inst) {
return inst.drawDate.newDate().
add(-inst.options.monthsToStep - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay);
},
action: function(inst) {
plugin.changeMonth(this, -inst.options.monthsToStep);
}
},
prevJump: {
text: 'prevJumpText',
status: 'prevJumpStatus', // Previous year
keystroke: {keyCode: 33, ctrlKey: true}, // Ctrl + Page up
enabled: function(inst) {
var minDate = inst.curMinDate();
return (!minDate || inst.drawDate.newDate().
add(1 - inst.options.monthsToJump - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay).add(-1, 'd').compareTo(minDate) !== -1);
},
date: function(inst) {
return inst.drawDate.newDate().
add(-inst.options.monthsToJump - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay);
},
action: function(inst) {
plugin.changeMonth(this, -inst.options.monthsToJump);
}
},
next: {
text: 'nextText',
status: 'nextStatus', // Next month
keystroke: {keyCode: 34}, // Page down
enabled: function(inst) {
var maxDate = inst.get('maxDate');
return (!maxDate || inst.drawDate.newDate().
add(inst.options.monthsToStep - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay).compareTo(maxDate) !== +1);
},
date: function(inst) {
return inst.drawDate.newDate().
add(inst.options.monthsToStep - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay);
},
action: function(inst) {
plugin.changeMonth(this, inst.options.monthsToStep);
}
},
nextJump: {
text: 'nextJumpText',
status: 'nextJumpStatus', // Next year
keystroke: {keyCode: 34, ctrlKey: true}, // Ctrl + Page down
enabled: function(inst) {
var maxDate = inst.get('maxDate');
return (!maxDate || inst.drawDate.newDate().
add(inst.options.monthsToJump - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay).compareTo(maxDate) !== +1);
},
date: function(inst) {
return inst.drawDate.newDate().
add(inst.options.monthsToJump - inst.options.monthsOffset, 'm').
day(inst.options.calendar.minDay);
},
action: function(inst) {
plugin.changeMonth(this, inst.options.monthsToJump);
}
},
current: {
text: 'currentText',
status: 'currentStatus', // Current month
keystroke: {keyCode: 36, ctrlKey: true}, // Ctrl + Home
enabled: function(inst) {
var minDate = inst.curMinDate();
var maxDate = inst.get('maxDate');
var curDate = inst.selectedDates[0] || inst.options.calendar.today();
return (!minDate || curDate.compareTo(minDate) !== -1) &&
(!maxDate || curDate.compareTo(maxDate) !== +1);
},
date: function(inst) {
return inst.selectedDates[0] || inst.options.calendar.today();
},
action: function(inst) {
var curDate = inst.selectedDates[0] || inst.options.calendar.today();
plugin.showMonth(this, curDate.year(), curDate.month());
}
},
today: {
text: 'todayText',
status: 'todayStatus', // Today's month
keystroke: {keyCode: 36, ctrlKey: true}, // Ctrl + Home
enabled: function(inst) {
var minDate = inst.curMinDate();
var maxDate = inst.get('maxDate');
return (!minDate || inst.options.calendar.today().compareTo(minDate) !== -1) &&
(!maxDate || inst.options.calendar.today().compareTo(maxDate) !== +1);
},
date: function(inst) {
return inst.options.calendar.today();
},
action: function() {
plugin.showMonth(this);
}
},
clear: {
text: 'clearText',
status: 'clearStatus', // Clear the datepicker
keystroke: {keyCode: 35, ctrlKey: true}, // Ctrl + End
enabled: function() { return true; },
date: function() { return null; },
action: function() { plugin.clear(this); }
},
close: {
text: 'closeText',
status: 'closeStatus', // Close the datepicker
keystroke: {keyCode: 27}, // Escape
enabled: function() { return true; },
date: function() { return null; },
action: function() { plugin.hide(this); }
},
prevWeek: {
text: 'prevWeekText',
status: 'prevWeekStatus', // Previous week
keystroke: {keyCode: 38, ctrlKey: true}, // Ctrl + Up
enabled: function(inst) {
var minDate = inst.curMinDate();
return (!minDate || inst.drawDate.newDate().
add(-inst.options.calendar.daysInWeek(), 'd').compareTo(minDate) !== -1);
},
date: function(inst) {
return inst.drawDate.newDate().add(-inst.options.calendar.daysInWeek(), 'd');
},
action: function(inst) {
plugin.changeDay(this, -inst.options.calendar.daysInWeek());
}
},
prevDay: {
text: 'prevDayText',
status: 'prevDayStatus', // Previous day
keystroke: {keyCode: 37, ctrlKey: true}, // Ctrl + Left
enabled: function(inst) {
var minDate = inst.curMinDate();
return (!minDate || inst.drawDate.newDate().add(-1, 'd').compareTo(minDate) !== -1);
},
date: function(inst) {
return inst.drawDate.newDate().add(-1, 'd');
},
action: function() {
plugin.changeDay(this, -1);
}
},
nextDay: {
text: 'nextDayText',
status: 'nextDayStatus', // Next day
keystroke: {keyCode: 39, ctrlKey: true}, // Ctrl + Right
enabled: function(inst) {
var maxDate = inst.get('maxDate');
return (!maxDate || inst.drawDate.newDate().add(1, 'd').compareTo(maxDate) !== +1);
},
date: function(inst) {
return inst.drawDate.newDate().add(1, 'd');
},
action: function() {
plugin.changeDay(this, 1);
}
},
nextWeek: {
text: 'nextWeekText',
status: 'nextWeekStatus', // Next week
keystroke: {keyCode: 40, ctrlKey: true}, // Ctrl + Down
enabled: function(inst) {
var maxDate = inst.get('maxDate');
return (!maxDate || inst.drawDate.newDate().
add(inst.options.calendar.daysInWeek(), 'd').compareTo(maxDate) !== +1);
},
date: function(inst) {
return inst.drawDate.newDate().add(inst.options.calendar.daysInWeek(), 'd');
},
action: function(inst) {
plugin.changeDay(this, inst.options.calendar.daysInWeek());
}
}
},
/** Determine whether a command is enabled.
@callback CalendarsPickerCommandEnabled
@param {object} inst The current instance settings.
@return {boolean} true if this command is enabled, false if not.
@example enabled: function(inst) {
return !!inst.curMinDate();
} */
/** Calculate the representative date for a command.
@callback CalendarsPickerCommandDate
@param {object} inst The current instance settings.
@return {CDate} A date appropriate for this command.
@example date: function(inst) {
return inst.curMinDate();
} */
/** Perform the action for a command.
@callback CalendarsPickerCommandAction
@param {object} inst The current instance settings.
@example date: function(inst) {
$.datepick.setDate(inst.elem, inst.curMinDate());
} */
/** Calculate the week of the year for a date.
@callback CalendarsPickerCalculateWeek
@param {CDate} date The date to evaluate.
@return {number} The week of the year.
@example calculateWeek: function(date) {
var startYear = date.newDate(date.year(), 1, 1);
return Math.floor((date.dayOfYear() - startYear.dayOfYear()) / 7) + 1;
} */
/** Provide information about an individual date shown in the calendar.
@callback CalendarsPickerOnDate
@param {CDate} date The date to evaluate.
@return {object} Information about that date, with the properties above.
@property {boolean} selectable true if this date can be selected.
@property {string} dateClass Class(es) to be applied to the date.
@property {string} content The date cell content.
@property {string} tooltip A popup tooltip for the date.
@example onDate: function(date) {
return {selectable: date.day() > 0 && date.day() < 5,
dateClass: date.day() === 4 ? 'last-day' : ''};
} */
/** Update the datepicker display.
@callback CalendarsPickerOnShow
@param {jQuery} picker The datepicker div to be shown.
@param {object} inst The current instance settings.
@example onShow: function(picker, inst) {
picker.append('').
find('button:last').click(function() {
alert('Hi!');
});
} */
/** React to navigating through the months/years.
@callback CalendarsPickerOnChangeMonthYear
@param {number} year The new year.
@param {number} month The new month (calendar minimum month to maximum month).
@example onChangeMonthYear: function(year, month) {
alert('Now in ' + month + '/' + year);
} */
/** Datepicker on select callback.
Triggered when a date is selected.
@callback CalendarsPickerOnSelect
@param {CDate[]} dates The selected date(s).
@example onSelect: function(dates) {
alert('Selected ' + dates);
} */
/** Datepicker on close callback.
Triggered when a popup calendar is closed.
@callback CalendarsPickerOnClose
@param {CDate[]} dates The selected date(s).
@example onClose: function(dates) {
alert('Selected ' + dates);
} */
/** Default settings for the plugin.
@memberof CalendarsPicker
@property {Calendar} [calendar=$.calendars.instance()] The calendar for this datepicker.
@property {string} [pickerClass=''] CSS class to add to this instance of the datepicker.
@property {boolean} [showOnFocus=true] true for popup on focus, false for not.
@property {string|Element|jQuery} [showTrigger=null] Element to be cloned for a trigger,
null for none.
@property {string} [showAnim='show'] Name of jQuery animation for popup, '' for no animation.
@property {object} [showOptions=null] Options for enhanced animations.
@property {string|number} [showSpeed='normal'] Duration of display/closure, named or in milliseconds.
@property {string|Element|jQuery} [popupContainer=null] The element to which a popup calendar is added,
null for body.
@property {string} [alignment='bottom'] Alignment of popup - with nominated corner of input:
'top' or 'bottom' aligns depending on language direction,
'topLeft', 'topRight', 'bottomLeft', 'bottomRight'.
@property {boolean} [fixedWeeks=false] true to always show 6 weeks,
false to only show as many as are needed.
@property {number} [firstDay=null] First day of the week, 0 = Sunday, 1 = Monday, etc.,
null for calendar default.
@property {CalendarsPickerCalculateWeek} [calculateWeek=null] Calculate week of the year from a date,
null for calendar default.
@property {boolean} [localNumbers=false] true to localise numbers (if available),
false to use normal Arabic numerals.
@property {number|number[]} [monthsToShow=1] How many months to show, cols or [rows, cols].
@property {number} [monthsOffset=0] How many months to offset the primary month by;
may be a function that takes the date and returns the offset.
@property {number} [monthsToStep=1] How many months to move when prev/next clicked.
@property {number} [monthsToJump=12] How many months to move when large prev/next clicked.
@property {boolean} [useMouseWheel=true] true to use mousewheel if available,
false to never use it.
@property {boolean} [changeMonth=true] true to change month/year via drop-down,
false for navigation only.
@property {string} [yearRange='c-10:c+10'] Range of years to show in drop-down: 'any' for direct text entry
or 'start:end', where start/end are '+-nn' for relative to today
or 'c+-nn' for relative to the currently selected date
or 'nnnn' for an absolute year.
@property {boolean} [showOtherMonths=false] true to show dates from other months,
false to not show them.
@property {boolean} [selectOtherMonths=false] true to allow selection of dates
from other months too.
@property {string|number|CDate} [defaultDate=null] Date to show if no other selected.
@property {boolean} [selectDefaultDate=false] true to pre-select the default date
if no other is chosen.
@property {string|number|CDate} [minDate=null] The minimum selectable date.
@property {string|number|CDate} [maxDate=null] The maximum selectable date.
@property {string} [dateFormat='mm/dd/yyyy'] Format for dates.
@property {boolean} [autoSize=false] true to size the input field according to the date format.
@property {boolean} [rangeSelect=false] Allows for selecting a date range on one date picker.
@property {string} [rangeSeparator=' - '] Text between two dates in a range.
@property {number} [multiSelect=0] Maximum number of selectable dates, zero for single select.
@property {string} [multiSeparator=','] Text between multiple dates.
@property {CalendarsPickerOnDate} [onDate=null] Callback as a date is added to the datepicker.
@property {CalendarsPickerOnShow} [onShow=null] Callback just before a datepicker is shown.
@property {CalendarsPickerOnChangeMonthYear} [onChangeMonthYear=null] Callback when a new month/year
is selected.
@property {CalendarsPickerOnSelect} [onSelect=null] Callback when a date is selected.
@property {CalendarsPickerOnClose} [onClose=null] Callback when a datepicker is closed.
@property {string|Element|jQuery} [altField=null] Alternate field to update in synch with the datepicker.
@property {string} [altFormat=null] Date format for alternate field, defaults to dateFormat.
@property {boolean} [constrainInput=true] true to constrain typed input to
dateFormat allowed characters.
@property {boolean} [commandsAsDateFormat=false] true to apply
formatDate to the command texts.
@property {object} [commands=this.commands] Command actions that may be added to a layout by name.
@example $(selector).calendarsPicker({calendar: $.calendars.instance('persian')})
$(selector).calendarsPicker({monthsToShow: [2, 3], monthsToStep: 6})
$(selector).calendarsPicker({minDate: $.calendars.newDate(2001, 1, 1),
maxDate: $.calendars.newDate(2010, 12, 31)}) */
defaultOptions: {
calendar: $.calendars.instance(),
pickerClass: '',
showOnFocus: true,
showTrigger: null,
showAnim: 'show',
showOptions: {},
showSpeed: 'normal',
popupContainer: null,
alignment: 'bottom',
fixedWeeks: false,
firstDay: null,
calculateWeek: null,
localNumbers: false,
monthsToShow: 1,
monthsOffset: 0,
monthsToStep: 1,
monthsToJump: 12,
useMouseWheel: true,
changeMonth: true,
yearRange: 'c-10:c+10',
showOtherMonths: false,
selectOtherMonths: false,
defaultDate: null,
selectDefaultDate: false,
minDate: null,
maxDate: null,
dateFormat: null,
autoSize: false,
rangeSelect: false,
rangeSeparator: ' - ',
multiSelect: 0,
multiSeparator: ',',
onDate: null,
onShow: null,
onChangeMonthYear: null,
onSelect: null,
onClose: null,
altField: null,
altFormat: null,
constrainInput: true,
commandsAsDateFormat: false,
commands: {} // this.commands
},
/** Localisations for the plugin.
Entries are objects indexed by the language code ('' being the default US/English).
Each object has the following attributes.
@memberof CalendarsPicker
@property {string} [renderer=this.defaultRenderer] The rendering templates.
@property {string} [prevText='<Prev'] Text for the previous month command.
@property {string} [prevStatus='Show the previous month'] Status text for the
previous month command.
@property {string} [prevJumpText='<<'] Text for the previous year command.
@property {string} [prevJumpStatus='Show the previous year'] Status text for the
previous year command.
@property {string} [nextText='Next>'] Text for the next month command.
@property {string} [nextStatus='Show the next month'] Status text for the next month command.
@property {string} [nextJumpText='>>'] Text for the next year command.
@property {string} [nextJumpStatus='Show the next year'] Status text for the
next year command.
@property {string} [currentText='Current'] Text for the current month command.
@property {string} [currentStatus='Show the current month'] Status text for the
current month command.
@property {string} [todayText='Today'] Text for the today's month command.
@property {string} [todayStatus='Show today\'s month'] Status text for the today's month command.
@property {string} [clearText='Clear'] Text for the clear command.
@property {string} [clearStatus='Clear all the dates'] Status text for the clear command.
@property {string} [closeText='Close'] Text for the close command.
@property {string} [closeStatus='Close the datepicker'] Status text for the close command.
@property {string} [yearStatus='Change the year'] Status text for year selection.
@property {string} [earlierText=' ▲'] Text for earlier years.
@property {string} [laterText=' ▼'] Text for later years.
@property {string} [monthStatus='Change the month'] Status text for month selection.
@property {string} [weekText='Wk'] Text for week of the year column header.
@property {string} [weekStatus='Week of the year'] Status text for week of the year
column header.
@property {string} [dayStatus='Select DD, M d, yyyy'] Status text for selectable days.
@property {string} [defaultStatus='Select a date'] Status text shown by default.
@property {boolean} [isRTL=false] true if language is right-to-left. */
regionalOptions: { // Available regional settings, indexed by language/country code
'': { // Default regional settings - English/US
renderer: {}, // this.defaultRenderer
prevText: '<Prev',
prevStatus: 'Show the previous month',
prevJumpText: '<<',
prevJumpStatus: 'Show the previous year',
nextText: 'Next>',
nextStatus: 'Show the next month',
nextJumpText: '>>',
nextJumpStatus: 'Show the next year',
currentText: 'Current',
currentStatus: 'Show the current month',
todayText: 'Today',
todayStatus: 'Show today\'s month',
clearText: 'Clear',
clearStatus: 'Clear all the dates',
closeText: 'Close',
closeStatus: 'Close the datepicker',
yearStatus: 'Change the year',
earlierText: ' ▲',
laterText: ' ▼',
monthStatus: 'Change the month',
weekText: 'Wk',
weekStatus: 'Week of the year',
dayStatus: 'Select DD, M d, yyyy',
defaultStatus: 'Select a date',
isRTL: false
}
},
_disabled: [],
_popupClass: 'calendars-popup', // Marker for popup division
_triggerClass: 'calendars-trigger', // Marker for trigger element
_disableClass: 'calendars-disable', // Marker for disabled element
_monthYearClass: 'calendars-month-year', // Marker for month/year inputs
_curMonthClass: 'calendars-month-', // Marker for current month/year
_anyYearClass: 'calendars-any-year', // Marker for year direct input
_curDoWClass: 'calendars-dow-', // Marker for day of week
_init: function() {
this.defaultOptions.commands = this.commands;
this.regionalOptions[''].renderer = this.defaultRenderer;
this._super();
},
_instSettings: function(elem, options) { // jshint unused:false
return {selectedDates: [], drawDate: null, pickingRange: false,
inline: ($.inArray(elem[0].nodeName.toLowerCase(), ['div', 'span']) > -1),
get: function(name) { // Get a setting value, computing if necessary
if ($.inArray(name, ['defaultDate', 'minDate', 'maxDate']) > -1) { // Decode date settings
return this.options.calendar.determineDate(this.options[name], null,
this.selectedDates[0], this.get('dateFormat'), this.getConfig());
}
if (name === 'dateFormat') {
return this.options.dateFormat || this.options.calendar.local.dateFormat;
}
return this.options[name];
},
curMinDate: function() {
return (this.pickingRange ? this.selectedDates[0] : this.get('minDate'));
},
getConfig: function() {
return {dayNamesShort: this.options.dayNamesShort, dayNames: this.options.dayNames,
monthNamesShort: this.options.monthNamesShort, monthNames: this.options.monthNames,
calculateWeek: this.options.calculateWeek, shortYearCutoff: this.options.shortYearCutoff};
}
};
},
_postAttach: function(elem, inst) {
if (inst.inline) {
inst.drawDate = plugin._checkMinMax((inst.selectedDates[0] ||
inst.get('defaultDate') || inst.options.calendar.today()).newDate(), inst);
inst.prevDate = inst.drawDate.newDate();
this._update(elem[0]);
if ($.fn.mousewheel) {
elem.mousewheel(this._doMouseWheel);
}
}
else {
this._attachments(elem, inst);
elem.on('keydown.' + inst.name, this._keyDown).on('keypress.' + inst.name, this._keyPress).
on('keyup.' + inst.name, this._keyUp);
if (elem.attr('disabled')) {
this.disable(elem[0]);
}
}
},
_optionsChanged: function(elem, inst, options) {
if (options.calendar && options.calendar !== inst.options.calendar) {
var discardDate = function(name) {
return (typeof inst.options[name] === 'object' ? null : inst.options[name]);
};
options = $.extend({defaultDate: discardDate('defaultDate'),
minDate: discardDate('minDate'), maxDate: discardDate('maxDate')}, options);
inst.selectedDates = [];
inst.drawDate = null;
}
var dates = inst.selectedDates;
$.extend(inst.options, options);
this.setDate(elem[0], dates, null, false, true);
inst.pickingRange = false;
var calendar = inst.options.calendar;
var defaultDate = inst.get('defaultDate');
inst.drawDate = this._checkMinMax((defaultDate ? defaultDate : inst.drawDate) ||
defaultDate || calendar.today(), inst).newDate();
if (!inst.inline) {
this._attachments(elem, inst);
}
if (inst.inline || inst.div) {
this._update(elem[0]);
}
},
/** Attach events and trigger, if necessary.
@memberof CalendarsPicker
@private
@param {jQuery} elem The control to affect.
@param {object} inst The current instance settings. */
_attachments: function(elem, inst) {
elem.off('focus.' + inst.name);
if (inst.options.showOnFocus) {
elem.on('focus.' + inst.name, this.show);
}
if (inst.trigger) {
inst.trigger.remove();
}
var trigger = inst.options.showTrigger;
inst.trigger = (!trigger ? $([]) :
$(trigger).clone().removeAttr('id').addClass(this._triggerClass)
[inst.options.isRTL ? 'insertBefore' : 'insertAfter'](elem).
click(function() {
if (!plugin.isDisabled(elem[0])) {
plugin[plugin.curInst === inst ? 'hide' : 'show'](elem[0]);
}
}));
this._autoSize(elem, inst);
var dates = this._extractDates(inst, elem.val());
if (dates) {
this.setDate(elem[0], dates, null, true);
}
var defaultDate = inst.get('defaultDate');
if (inst.options.selectDefaultDate && defaultDate && inst.selectedDates.length === 0) {
this.setDate(elem[0], (defaultDate || inst.options.calendar.today()).newDate());
}
},
/** Apply the maximum length for the date format.
@memberof CalendarsPicker
@private
@param {jQuery} elem The control to affect.
@param {object} inst The current instance settings. */
_autoSize: function(elem, inst) {
if (inst.options.autoSize && !inst.inline) {
var calendar = inst.options.calendar;
var date = calendar.newDate(2009, 10, 20); // Ensure double digits
var dateFormat = inst.get('dateFormat');
if (dateFormat.match(/[DM]/)) {
var findMax = function(names) {
var max = 0;
var maxI = 0;
for (var i = 0; i < names.length; i++) {
if (names[i].length > max) {
max = names[i].length;
maxI = i;
}
}
return maxI;
};
date.month(findMax(calendar.local[dateFormat.match(/MM/) ? // Longest month
'monthNames' : 'monthNamesShort']) + 1);
date.day(findMax(calendar.local[dateFormat.match(/DD/) ? // Longest day
'dayNames' : 'dayNamesShort']) + 20 - date.dayOfWeek());
}
inst.elem.attr('size', date.formatDate(dateFormat,
{localNumbers: inst.options.localnumbers}).length);
}
},
_preDestroy: function(elem, inst) {
if (inst.trigger) {
inst.trigger.remove();
}
elem.empty().off('.' + inst.name);
if (inst.inline && $.fn.mousewheel) {
elem.unmousewheel();
}
if (!inst.inline && inst.options.autoSize) {
elem.removeAttr('size');
}
},
/** Apply multiple event functions.
@memberof CalendarsPicker
@param {function} fns The functions to apply.
@example onShow: multipleEvents(fn1, fn2, ...) */
multipleEvents: function(fns) { // jshint unused:false
var funcs = arguments;
return function() {
for (var i = 0; i < funcs.length; i++) {
funcs[i].apply(this, arguments);
}
};
},
/** Enable the control.
@memberof CalendarsPicker
@param {Element} elem The control to affect.
@example $(selector).datepick('enable') */
enable: function(elem) {
elem = $(elem);
if (!elem.hasClass(this._getMarker())) {
return;
}
var inst = this._getInst(elem);
if (inst.inline) {
elem.children('.' + this._disableClass).remove().end().
find('button,select').prop('disabled', false).end().
find('a').attr('href', '#');
}
else {
elem.prop('disabled', false);
inst.trigger.filter('button.' + this._triggerClass).prop('disabled', false).end().
filter('img.' + this._triggerClass).css({opacity: '1.0', cursor: ''});
}
this._disabled = $.map(this._disabled,
function(value) { return (value === elem[0] ? null : value); }); // Delete entry
},
/** Disable the control.
@memberof CalendarsPicker
@param {Element} elem The control to affect.
@example $(selector).datepick('disable') */
disable: function(elem) {
elem = $(elem);
if (!elem.hasClass(this._getMarker())) {
return;
}
var inst = this._getInst(elem);
if (inst.inline) {
var inline = elem.children(':last');
var offset = inline.offset();
var relOffset = {left: 0, top: 0};
inline.parents().each(function() {
if ($(this).css('position') === 'relative') {
relOffset = $(this).offset();
return false;
}
});
var zIndex = elem.css('zIndex');
zIndex = (zIndex === 'auto' ? 0 : parseInt(zIndex, 10)) + 1;
elem.prepend('').
find('button,select').prop('disabled', true).end().
find('a').removeAttr('href');
}
else {
elem.prop('disabled', true);
inst.trigger.filter('button.' + this._triggerClass).prop('disabled', true).end().
filter('img.' + this._triggerClass).css({opacity: '0.5', cursor: 'default'});
}
this._disabled = $.map(this._disabled,
function(value) { return (value === elem[0] ? null : value); }); // Delete entry
this._disabled.push(elem[0]);
},
/** Is the first field in a jQuery collection disabled as a datepicker?
@memberof CalendarsPicker
@param {Element} elem The control to examine.
@return {boolean} true if disabled, false if enabled.
@example if ($(selector).datepick('isDisabled')) {...} */
isDisabled: function(elem) {
return (elem && $.inArray(elem, this._disabled) > -1);
},
/** Show a popup datepicker.
@memberof CalendarsPicker
@param {Event|Element} elem a focus event or the control to use.
@example $(selector).datepick('show') */
show: function(elem) {
elem = $(elem.target || elem);
var inst = plugin._getInst(elem);
if (plugin.curInst === inst) {
return;
}
if (plugin.curInst) {
plugin.hide(plugin.curInst, true);
}
if (!$.isEmptyObject(inst)) {
// Retrieve existing date(s)
inst.lastVal = null;
inst.selectedDates = plugin._extractDates(inst, elem.val());
inst.pickingRange = false;
inst.drawDate = plugin._checkMinMax((inst.selectedDates[0] ||
inst.get('defaultDate') || inst.options.calendar.today()).newDate(), inst);
inst.prevDate = inst.drawDate.newDate();
plugin.curInst = inst;
// Generate content
plugin._update(elem[0], true);
// Adjust position before showing
var offset = plugin._checkOffset(inst);
inst.div.css({left: offset.left, top: offset.top});
// And display
var showAnim = inst.options.showAnim;
var showSpeed = inst.options.showSpeed;
showSpeed = (showSpeed === 'normal' && $.ui &&
parseInt($.ui.version.substring(2)) >= 8 ? '_default' : showSpeed);
if ($.effects && ($.effects[showAnim] || ($.effects.effect && $.effects.effect[showAnim]))) {
var data = inst.div.data(); // Update old effects data
for (var key in data) {
if (key.match(/^ec\.storage\./)) {
data[key] = inst._mainDiv.css(key.replace(/ec\.storage\./, ''));
}
}
inst.div.data(data).show(showAnim, inst.options.showOptions, showSpeed);
}
else {
inst.div[showAnim || 'show'](showAnim ? showSpeed : 0);
}
}
},
/** Extract possible dates from a string.
@memberof CalendarsPicker
@private
@param {object} inst The current instance settings.
@param {string} text The text to extract from.
@return {CDate[]} The extracted dates. */
_extractDates: function(inst, datesText) {
if (datesText === inst.lastVal) {
return;
}
inst.lastVal = datesText;
datesText = datesText.split(inst.options.multiSelect ? inst.options.multiSeparator :
(inst.options.rangeSelect ? inst.options.rangeSeparator : '\x00'));
var dates = [];
for (var i = 0; i < datesText.length; i++) {
try {
var date = inst.options.calendar.parseDate(inst.get('dateFormat'), datesText[i]);
if (date) {
var found = false;
for (var j = 0; j < dates.length; j++) {
if (dates[j].compareTo(date) === 0) {
found = true;
break;
}
}
if (!found) {
dates.push(date);
}
}
}
catch (e) {
// Ignore
}
}
dates.splice(inst.options.multiSelect || (inst.options.rangeSelect ? 2 : 1), dates.length);
if (inst.options.rangeSelect && dates.length === 1) {
dates[1] = dates[0];
}
return dates;
},
/** Update the datepicker display.
@memberof CalendarsPicker
@private
@param {Event|Element} elem A focus event or the control to use.
@param {boolean} hidden true to initially hide the datepicker. */
_update: function(elem, hidden) {
elem = $(elem.target || elem);
var inst = plugin._getInst(elem);
if (!$.isEmptyObject(inst)) {
if (inst.inline || plugin.curInst === inst) {
if ($.isFunction(inst.options.onChangeMonthYear) && (!inst.prevDate ||
inst.prevDate.year() !== inst.drawDate.year() ||
inst.prevDate.month() !== inst.drawDate.month())) {
inst.options.onChangeMonthYear.apply(elem[0],
[inst.drawDate.year(), inst.drawDate.month()]);
}
}
if (inst.inline) {
var index = $('a, :input', elem).index($(':focus', elem));
elem.html(this._generateContent(elem[0], inst));
var focus = elem.find('a, :input');
focus.eq(Math.max(Math.min(index, focus.length - 1), 0)).focus();
}
else if (plugin.curInst === inst) {
if (!inst.div) {
inst.div = $('').addClass(this._popupClass).
css({display: (hidden ? 'none' : 'static'), position: 'absolute',
left: elem.offset().left, top: elem.offset().top + elem.outerHeight()}).
appendTo($(inst.options.popupContainer || 'body'));
if ($.fn.mousewheel) {
inst.div.mousewheel(this._doMouseWheel);
}
}
inst.div.html(this._generateContent(elem[0], inst));
elem.focus();
}
}
},
/** Update the input field and any alternate field with the current dates.
@memberof CalendarsPicker
@private
@param {Element} elem The control to use.
@param {boolean} keyUp true if coming from keyUp processing (internal). */
_updateInput: function(elem, keyUp) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst)) {
var value = '';
var altValue = '';
var sep = (inst.options.multiSelect ? inst.options.multiSeparator :
inst.options.rangeSeparator);
var calendar = inst.options.calendar;
var dateFormat = inst.get('dateFormat');
var altFormat = inst.options.altFormat || dateFormat;
var settings = {localNumbers: inst.options.localNumbers};
for (var i = 0; i < inst.selectedDates.length; i++) {
value += (keyUp ? '' : (i > 0 ? sep : '') +
calendar.formatDate(dateFormat, inst.selectedDates[i], settings));
altValue += (i > 0 ? sep : '') +
calendar.formatDate(altFormat, inst.selectedDates[i], settings);
}
if (!inst.inline && !keyUp) {
$(elem).val(value);
}
$(inst.options.altField).val(altValue);
if ($.isFunction(inst.options.onSelect) && !keyUp && !inst.inSelect) {
inst.inSelect = true; // Prevent endless loops
inst.options.onSelect.apply(elem, [inst.selectedDates]);
inst.inSelect = false;
}
$(elem).change();
}
},
/** Retrieve the size of left and top borders for an element.
@memberof CalendarsPicker
@private
@param {jQuery} elem The element of interest.
@return {number[]} The left and top borders. */
_getBorders: function(elem) {
var convert = function(value) {
return {thin: 1, medium: 3, thick: 5}[value] || value;
};
return [parseFloat(convert(elem.css('border-left-width'))),
parseFloat(convert(elem.css('border-top-width')))];
},
/** Check positioning to remain on the screen.
@memberof CalendarsPicker
@private
@param {object} inst The current instance settings.
@return {object} The updated offset for the datepicker. */
_checkOffset: function(inst) {
var base = (inst.elem.is(':hidden') && inst.trigger ? inst.trigger : inst.elem);
var offset = base.offset();
var browserWidth = $(window).width();
var browserHeight = $(window).height();
if (browserWidth === 0) {
return offset;
}
var isFixed = false;
$(inst.elem).parents().each(function() {
isFixed = isFixed || $(this).css('position') === 'fixed';
return !isFixed;
});
var scrollX = document.documentElement.scrollLeft || document.body.scrollLeft;
var scrollY = document.documentElement.scrollTop || document.body.scrollTop;
var above = offset.top - (isFixed ? scrollY : 0) - inst.div.outerHeight();
var below = offset.top - (isFixed ? scrollY : 0) + base.outerHeight();
var alignL = offset.left - (isFixed ? scrollX : 0);
var alignR = offset.left - (isFixed ? scrollX : 0) + base.outerWidth() - inst.div.outerWidth();
var tooWide = (offset.left - scrollX + inst.div.outerWidth()) > browserWidth;
var tooHigh = (offset.top - scrollY + inst.elem.outerHeight() +
inst.div.outerHeight()) > browserHeight;
inst.div.css('position', isFixed ? 'fixed' : 'absolute');
var alignment = inst.options.alignment;
if (alignment === 'topLeft') {
offset = {left: alignL, top: above};
}
else if (alignment === 'topRight') {
offset = {left: alignR, top: above};
}
else if (alignment === 'bottomLeft') {
offset = {left: alignL, top: below};
}
else if (alignment === 'bottomRight') {
offset = {left: alignR, top: below};
}
else if (alignment === 'top') {
offset = {left: (inst.options.isRTL || tooWide ? alignR : alignL), top: above};
}
else { // bottom
offset = {left: (inst.options.isRTL || tooWide ? alignR : alignL),
top: (tooHigh ? above : below)};
}
offset.left = Math.max((isFixed ? 0 : scrollX), offset.left);
offset.top = Math.max((isFixed ? 0 : scrollY), offset.top);
return offset;
},
/** Close date picker if clicked elsewhere.
@memberof CalendarsPicker
@private
@param {MouseEvent} event The mouse click to check. */
_checkExternalClick: function(event) {
if (!plugin.curInst) {
return;
}
var elem = $(event.target);
if (elem.closest('.' + plugin._popupClass + ',.' + plugin._triggerClass).length === 0 &&
!elem.hasClass(plugin._getMarker())) {
plugin.hide(plugin.curInst);
}
},
/** Hide a popup datepicker.
@memberof CalendarsPicker
@param {Element|object} elem The control to use or the current instance settings.
@param {boolean} immediate true to close immediately without animation (internal).
@example $(selector).datepick('hide') */
hide: function(elem, immediate) {
if (!elem) {
return;
}
var inst = this._getInst(elem);
if ($.isEmptyObject(inst)) {
inst = elem;
}
if (inst && inst === plugin.curInst) {
var showAnim = (immediate ? '' : inst.options.showAnim);
var showSpeed = inst.options.showSpeed;
showSpeed = (showSpeed === 'normal' && $.ui &&
parseInt($.ui.version.substring(2)) >= 8 ? '_default' : showSpeed);
var postProcess = function() {
if (!inst.div) {
return;
}
inst.div.remove();
inst.div = null;
plugin.curInst = null;
if ($.isFunction(inst.options.onClose)) {
inst.options.onClose.apply(elem, [inst.selectedDates]);
}
};
inst.div.stop();
if ($.effects && ($.effects[showAnim] || ($.effects.effect && $.effects.effect[showAnim]))) {
inst.div.hide(showAnim, inst.options.showOptions, showSpeed, postProcess);
}
else {
var hideAnim = (showAnim === 'slideDown' ? 'slideUp' :
(showAnim === 'fadeIn' ? 'fadeOut' : 'hide'));
inst.div[hideAnim]((showAnim ? showSpeed : ''), postProcess);
}
if (!showAnim) {
postProcess();
}
}
},
/** Handle keystrokes in the datepicker.
@memberof CalendarsPicker
@private
@param {KeyEvent} event The keystroke.
@return {boolean} true if not handled, false if handled. */
_keyDown: function(event) {
var elem = (event.data && event.data.elem) || event.target;
var inst = plugin._getInst(elem);
var handled = false;
var command;
if (inst.inline || inst.div) {
if (event.keyCode === 9) { // Tab - close
plugin.hide(elem);
}
else if (event.keyCode === 13) { // Enter - select
plugin.selectDate(elem,
$('a.' + inst.options.renderer.highlightedClass, inst.div)[0]);
handled = true;
}
else { // Command keystrokes
var commands = inst.options.commands;
for (var name in commands) {
if (inst.options.commands.hasOwnProperty(name)) {
command = commands[name];
/* jshint -W018 */ // Dislikes !!
if (command.keystroke.keyCode === event.keyCode &&
!!command.keystroke.ctrlKey === !!(event.ctrlKey || event.metaKey) &&
!!command.keystroke.altKey === event.altKey &&
!!command.keystroke.shiftKey === event.shiftKey) {
/* jshint +W018 */
plugin.performAction(elem, name);
handled = true;
break;
}
}
}
}
}
else { // Show on 'current' keystroke
command = inst.options.commands.current;
/* jshint -W018 */ // Dislikes !!
if (command.keystroke.keyCode === event.keyCode &&
!!command.keystroke.ctrlKey === !!(event.ctrlKey || event.metaKey) &&
!!command.keystroke.altKey === event.altKey &&
!!command.keystroke.shiftKey === event.shiftKey) {
/* jshint +W018 */
plugin.show(elem);
handled = true;
}
}
inst.ctrlKey = ((event.keyCode < 48 && event.keyCode !== 32) || event.ctrlKey || event.metaKey);
if (handled) {
event.preventDefault();
event.stopPropagation();
}
return !handled;
},
/** Filter keystrokes in the datepicker.
@memberof CalendarsPicker
@private
@param {KeyEvent} event The keystroke.
@return {boolean} true if allowed, false if not allowed. */
_keyPress: function(event) {
var inst = plugin._getInst((event.data && event.data.elem) || event.target);
if (!$.isEmptyObject(inst) && inst.options.constrainInput) {
var ch = String.fromCharCode(event.keyCode || event.charCode);
var allowedChars = plugin._allowedChars(inst);
return (event.metaKey || inst.ctrlKey || ch < ' ' ||
!allowedChars || allowedChars.indexOf(ch) > -1);
}
return true;
},
/** Determine the set of characters allowed by the date format.
@memberof CalendarsPicker
@private
@param {object} inst The current instance settings.
@return {string} The set of allowed characters, or null if anything allowed. */
_allowedChars: function(inst) {
var allowedChars = (inst.options.multiSelect ? inst.options.multiSeparator :
(inst.options.rangeSelect ? inst.options.rangeSeparator : ''));
var literal = false;
var hasNum = false;
var dateFormat = inst.get('dateFormat');
for (var i = 0; i < dateFormat.length; i++) {
var ch = dateFormat.charAt(i);
if (literal) {
if (ch === '\'' && dateFormat.charAt(i + 1) !== '\'') {
literal = false;
}
else {
allowedChars += ch;
}
}
else {
switch (ch) {
case 'd':
case 'm':
case 'o':
case 'w':
allowedChars += (hasNum ? '' : '0123456789');
hasNum = true;
break;
case 'y':
case '@':
case '!':
allowedChars += (hasNum ? '' : '0123456789') + '-';
hasNum = true;
break;
case 'J':
allowedChars += (hasNum ? '' : '0123456789') + '-.';
hasNum = true;
break;
case 'D':
case 'M':
case 'Y':
return null; // Accept anything
case '\'':
if (dateFormat.charAt(i + 1) === '\'') {
allowedChars += '\'';
}
else {
literal = true;
}
break;
default:
allowedChars += ch;
}
}
}
return allowedChars;
},
/** Synchronise datepicker with the field.
@memberof CalendarsPicker
@private
@param {KeyEvent} event The keystroke.
@return {boolean} true if allowed, false if not allowed. */
_keyUp: function(event) {
var elem = (event.data && event.data.elem) || event.target;
var inst = plugin._getInst(elem);
if (!$.isEmptyObject(inst) && !inst.ctrlKey && inst.lastVal !== inst.elem.val()) {
try {
var dates = plugin._extractDates(inst, inst.elem.val());
if (dates.length > 0) {
plugin.setDate(elem, dates, null, true);
}
}
catch (e) {
// Ignore
}
}
return true;
},
/** Increment/decrement month/year on mouse wheel activity.
@memberof CalendarsPicker
@private
@param {event} event The mouse wheel event.
@param {number} delta The amount of change. */
_doMouseWheel: function(event, delta) {
var elem = (plugin.curInst && plugin.curInst.elem[0]) ||
$(event.target).closest('.' + plugin._getMarker())[0];
if (plugin.isDisabled(elem)) {
return;
}
var inst = plugin._getInst(elem);
if (inst.options.useMouseWheel) {
delta = (delta < 0 ? -1 : +1);
plugin.changeMonth(elem, -inst.options[event.ctrlKey ? 'monthsToJump' : 'monthsToStep'] * delta);
}
event.preventDefault();
},
/** Clear an input and close a popup datepicker.
@memberof CalendarsPicker
@param {Element} elem The control to use.
@example $(selector).datepick('clear') */
clear: function(elem) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst)) {
inst.selectedDates = [];
this.hide(elem);
var defaultDate = inst.get('defaultDate');
if (inst.options.selectDefaultDate && defaultDate) {
this.setDate(elem, (defaultDate || inst.options.calendar.today()).newDate());
}
else {
this._updateInput(elem);
}
}
},
/** Retrieve the selected date(s) for a datepicker.
@memberof CalendarsPicker
@param {Element} elem The control to examine.
@return {CDate[]} The selected date(s).
@example var dates = $(selector).datepick('getDate') */
getDate: function(elem) {
var inst = this._getInst(elem);
return (!$.isEmptyObject(inst) ? inst.selectedDates : []);
},
/** Set the selected date(s) for a datepicker.
@memberof CalendarsPicker
@param {Element} elem The control to examine.
@param {CDate|number|string|array} dates The selected date(s).
@param {CDate|number|string} [endDate] The ending date for a range.
@param {boolean} [keyUp] true if coming from keyUp processing (internal).
@param {boolean} [setOpt] true if coming from option processing (internal).
@example $(selector).datepick('setDate', new Date(2014, 12-1, 25))
$(selector).datepick('setDate', '12/25/2014', '01/01/2015')
$(selector).datepick('setDate', [date1, date2, date3]) */
setDate: function(elem, dates, endDate, keyUp, setOpt) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst)) {
if (!$.isArray(dates)) {
dates = [dates];
if (endDate) {
dates.push(endDate);
}
}
var minDate = inst.get('minDate');
var maxDate = inst.get('maxDate');
var curDate = inst.selectedDates[0];
inst.selectedDates = [];
for (var i = 0; i < dates.length; i++) {
var date = inst.options.calendar.determineDate(
dates[i], null, curDate, inst.get('dateFormat'), inst.getConfig());
if (date) {
if ((!minDate || date.compareTo(minDate) !== -1) &&
(!maxDate || date.compareTo(maxDate) !== +1)) {
var found = false;
for (var j = 0; j < inst.selectedDates.length; j++) {
if (inst.selectedDates[j].compareTo(date) === 0) {
found = true;
break;
}
}
if (!found) {
inst.selectedDates.push(date);
}
}
}
}
inst.selectedDates.splice(inst.options.multiSelect ||
(inst.options.rangeSelect ? 2 : 1), inst.selectedDates.length);
if (inst.options.rangeSelect) {
switch (inst.selectedDates.length) {
case 1:
inst.selectedDates[1] = inst.selectedDates[0];
break;
case 2:
inst.selectedDates[1] = (inst.selectedDates[0].compareTo(inst.selectedDates[1]) === +1 ?
inst.selectedDates[0] : inst.selectedDates[1]);
break;
}
inst.pickingRange = false;
}
inst.prevDate = (inst.drawDate ? inst.drawDate.newDate() : null);
inst.drawDate = this._checkMinMax((inst.selectedDates[0] ||
inst.get('defaultDate') || inst.options.calendar.today()).newDate(), inst);
if (!setOpt) {
this._update(elem);
this._updateInput(elem, keyUp);
}
}
},
/** Determine whether a date is selectable for this datepicker.
@memberof CalendarsPicker
@private
@param {Element} elem The control to check.
@param {CDate|string|number} date The date to check.
@return {boolean} true if selectable, false if not.
@example var selectable = $(selector).datepick('isSelectable', date) */
isSelectable: function(elem, date) {
var inst = this._getInst(elem);
if ($.isEmptyObject(inst)) {
return false;
}
date = inst.options.calendar.determineDate(date,
inst.selectedDates[0] || inst.options.calendar.today(), null,
inst.options.dateFormat, inst.getConfig());
return this._isSelectable(elem, date, inst.options.onDate,
inst.get('minDate'), inst.get('maxDate'));
},
/** Internally determine whether a date is selectable for this datepicker.
@memberof CalendarsPicker
@private
@param {Element} elem The control to check.
@param {CDate} date The date to check.
@param {function|boolean} onDate Any onDate callback or callback.selectable.
@param {CDate} minDate The minimum allowed date.
@param {CDate} maxDate The maximum allowed date.
@return {boolean} true if selectable, false if not. */
_isSelectable: function(elem, date, onDate, minDate, maxDate) {
var dateInfo = (typeof onDate === 'boolean' ? {selectable: onDate} :
(!$.isFunction(onDate) ? {} : onDate.apply(elem, [date, true])));
return (dateInfo.selectable !== false) &&
(!minDate || date.toJD() >= minDate.toJD()) && (!maxDate || date.toJD() <= maxDate.toJD());
},
/** Perform a named action for a datepicker.
@memberof CalendarsPicker
@param {element} elem The control to affect.
@param {string} action The name of the {@link CalendarsPicker.commands|action}.
@example $(selector).calendarsPicker('performAction', 'next') */
performAction: function(elem, action) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst) && !this.isDisabled(elem)) {
var commands = inst.options.commands;
if (commands[action] && commands[action].enabled.apply(elem, [inst])) {
commands[action].action.apply(elem, [inst]);
}
}
},
/** Set the currently shown month, defaulting to today's.
@memberof CalendarsPicker
@param {Element} elem The control to affect.
@param {number} [year] The year to show.
@param {number} [month] The month to show (calendar minimum month to maximum month).
@param {number} [day] The day to show.
@example $(selector).datepick('showMonth', 2014, 12, 25) */
showMonth: function(elem, year, month, day) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst) && ((typeof day !== 'undefined' && day !== null) ||
inst.drawDate.year() !== year || inst.drawDate.month() !== month)) {
inst.prevDate = inst.drawDate.newDate();
var calendar = inst.options.calendar;
var show = this._checkMinMax(typeof year !== 'undefined' && year !== null ?
calendar.newDate(year, month, 1) : calendar.today(), inst);
inst.drawDate.date(show.year(), show.month(),
typeof day !== 'undefined' && day !== null ? day : Math.min(inst.drawDate.day(),
calendar.daysInMonth(show.year(), show.month())));
this._update(elem);
}
},
/** Adjust the currently shown month.
@memberof CalendarsPicker
@param {Element} elem The control to affect.
@param {number} offset The number of months to change by.
@example $(selector).datepick('changeMonth', 2)*/
changeMonth: function(elem, offset) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst)) {
var date = inst.drawDate.newDate().add(offset, 'm');
this.showMonth(elem, date.year(), date.month());
}
},
/** Adjust the currently shown day.
@memberof CalendarsPicker
@param {Element} elem The control to affect.
@param {number} offset The number of days to change by.
@example $(selector).datepick('changeDay', 7)*/
changeDay: function(elem, offset) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst)) {
var date = inst.drawDate.newDate().add(offset, 'd');
this.showMonth(elem, date.year(), date.month(), date.day());
}
},
/** Restrict a date to the minimum/maximum specified.
@memberof CalendarsPicker
@private
@param {CDate} date The date to check.
@param {object} inst The current instance settings. */
_checkMinMax: function(date, inst) {
var minDate = inst.get('minDate');
var maxDate = inst.get('maxDate');
date = (minDate && date.compareTo(minDate) === -1 ? minDate.newDate() : date);
date = (maxDate && date.compareTo(maxDate) === +1 ? maxDate.newDate() : date);
return date;
},
/** Retrieve the date associated with an entry in the datepicker.
@memberof CalendarsPicker
@param {Element} elem The control to examine.
@param {Element} target The selected datepicker element.
@return {CDate} The corresponding date, or null.
@example var date = $(selector).datepick('retrieveDate',
$('div.datepick-popup a:contains(10)')[0]) */
retrieveDate: function(elem, target) {
var inst = this._getInst(elem);
return ($.isEmptyObject(inst) ? null : inst.options.calendar.fromJD(
parseFloat(target.className.replace(/^.*jd(\d+\.5).*$/, '$1'))));
},
/** Select a date for this datepicker.
@memberof CalendarsPicker
@param {Element} elem The control to examine.
@param {Element} target The selected datepicker element.
@example $(selector).datepick('selectDate', $('div.datepick-popup a:contains(10)')[0]) */
selectDate: function(elem, target) {
var inst = this._getInst(elem);
if (!$.isEmptyObject(inst) && !this.isDisabled(elem)) {
var date = this.retrieveDate(elem, target);
if (inst.options.multiSelect) {
var found = false;
for (var i = 0; i < inst.selectedDates.length; i++) {
if (date.compareTo(inst.selectedDates[i]) === 0) {
inst.selectedDates.splice(i, 1);
found = true;
break;
}
}
if (!found && inst.selectedDates.length < inst.options.multiSelect) {
inst.selectedDates.push(date);
}
}
else if (inst.options.rangeSelect) {
if (inst.pickingRange) {
inst.selectedDates[1] = date;
}
else {
inst.selectedDates = [date, date];
}
inst.pickingRange = !inst.pickingRange;
}
else {
inst.selectedDates = [date];
}
inst.prevDate = inst.drawDate = date.newDate();
this._updateInput(elem);
if (inst.inline || inst.pickingRange || inst.selectedDates.length <
(inst.options.multiSelect || (inst.options.rangeSelect ? 2 : 1))) {
this._update(elem);
}
else {
this.hide(elem);
}
}
},
/** Generate the datepicker content for this control.
@memberof CalendarsPicker
@private
@param {Element} elem The control to affect.
@param {object} inst The current instance settings.
@return {jQuery} The datepicker content */
_generateContent: function(elem, inst) {
var monthsToShow = inst.options.monthsToShow;
monthsToShow = ($.isArray(monthsToShow) ? monthsToShow : [1, monthsToShow]);
inst.drawDate = this._checkMinMax(
inst.drawDate || inst.get('defaultDate') || inst.options.calendar.today(), inst);
var drawDate = inst.drawDate.newDate().add(-inst.options.monthsOffset, 'm');
// Generate months
var monthRows = '';
for (var row = 0; row < monthsToShow[0]; row++) {
var months = '';
for (var col = 0; col < monthsToShow[1]; col++) {
months += this._generateMonth(elem, inst, drawDate.year(),
drawDate.month(), inst.options.calendar, inst.options.renderer, (row === 0 && col === 0));
drawDate.add(1, 'm');
}
monthRows += this._prepare(inst.options.renderer.monthRow, inst).replace(/\{months\}/, months);
}
var picker = this._prepare(inst.options.renderer.picker, inst).replace(/\{months\}/, monthRows).
replace(/\{weekHeader\}/g, this._generateDayHeaders(inst, inst.options.calendar, inst.options.renderer));
// Add commands
var addCommand = function(type, open, close, name, classes) {
if (picker.indexOf('{' + type + ':' + name + '}') === -1) {
return;
}
var command = inst.options.commands[name];
var date = (inst.options.commandsAsDateFormat ? command.date.apply(elem, [inst]) : null);
picker = picker.replace(new RegExp('\\{' + type + ':' + name + '\\}', 'g'),
'<' + open + (command.status ? ' title="' + inst.options[command.status] + '"' : '') +
' class="' + inst.options.renderer.commandClass + ' ' +
inst.options.renderer.commandClass + '-' + name + ' ' + classes +
(command.enabled(inst) ? '' : ' ' + inst.options.renderer.disabledClass) + '">' +
(date ? date.formatDate(inst.options[command.text], {localNumbers: inst.options.localNumbers}) :
inst.options[command.text]) + '');
};
for (var name in inst.options.commands) {
if (inst.options.commands.hasOwnProperty(name)) {
addCommand('button', 'button type="button"', 'button', name,
inst.options.renderer.commandButtonClass);
addCommand('link', 'a href="javascript:void(0)"', 'a', name,
inst.options.renderer.commandLinkClass);
}
}
picker = $(picker);
if (monthsToShow[1] > 1) {
var count = 0;
$(inst.options.renderer.monthSelector, picker).each(function() {
var nth = ++count % monthsToShow[1];
$(this).addClass(nth === 1 ? 'first' : (nth === 0 ? 'last' : ''));
});
}
// Add datepicker behaviour
var self = this;
function removeHighlight(elem) {
(inst.inline ? $(elem).closest('.' + self._getMarker()) : inst.div).
find(inst.options.renderer.daySelector + ' a').
removeClass(inst.options.renderer.highlightedClass);
}
picker.find(inst.options.renderer.daySelector + ' a').hover(
function() {
removeHighlight(this);
$(this).addClass(inst.options.renderer.highlightedClass);
},
function() {
removeHighlight(this);
}).
click(function() {
self.selectDate(elem, this);
}).end().
find('select.' + this._monthYearClass + ':not(.' + this._anyYearClass + ')').
change(function() {
var monthYear = $(this).val().split('/');
self.showMonth(elem, parseInt(monthYear[1], 10), parseInt(monthYear[0], 10));
}).end().
find('select.' + this._anyYearClass).click(function() {
$(this).css('visibility', 'hidden').
next('input').css({left: this.offsetLeft, top: this.offsetTop,
width: this.offsetWidth, height: this.offsetHeight}).show().focus();
}).end().
find('input.' + self._monthYearClass).change(function() {
try {
var year = parseInt($(this).val(), 10);
year = (isNaN(year) ? inst.drawDate.year() : year);
self.showMonth(elem, year, inst.drawDate.month(), inst.drawDate.day());
}
catch (e) {
// Ignore
}
}).keydown(function(event) {
if (event.keyCode === 13) { // Enter
$(event.elem).change();
}
else if (event.keyCode === 27) { // Escape
$(event.elem).hide().prev('select').css('visibility', 'visible');
inst.elem.focus();
}
});
// Add keyboard handling
var data = {elem: inst.elem[0]};
picker.keydown(data, this._keyDown).keypress(data, this._keyPress).keyup(data, this._keyUp);
// Add command behaviour
picker.find('.' + inst.options.renderer.commandClass).click(function() {
if (!$(this).hasClass(inst.options.renderer.disabledClass)) {
var action = this.className.replace(
new RegExp('^.*' + inst.options.renderer.commandClass + '-([^ ]+).*$'), '$1');
plugin.performAction(elem, action);
}
});
// Add classes
if (inst.options.isRTL) {
picker.addClass(inst.options.renderer.rtlClass);
}
if (monthsToShow[0] * monthsToShow[1] > 1) {
picker.addClass(inst.options.renderer.multiClass);
}
if (inst.options.pickerClass) {
picker.addClass(inst.options.pickerClass);
}
// Resize
$('body').append(picker);
var width = 0;
picker.find(inst.options.renderer.monthSelector).each(function() {
width += $(this).outerWidth();
});
picker.width(width / monthsToShow[0]);
// Pre-show customisation
if ($.isFunction(inst.options.onShow)) {
inst.options.onShow.apply(elem, [picker, inst.options.calendar, inst]);
}
return picker;
},
/** Generate the content for a single month.
@memberof CalendarsPicker
@private
@param {Element} elem The control to affect.
@param {object} inst The current instance settings.
@param {number} year The year to generate.
@param {number} month The month to generate.
@param {BaseCalendar} calendar The current calendar.
@param {object} renderer The rendering templates.
@param {boolean} first true if first of multiple months.
@return {string} The month content. */
_generateMonth: function(elem, inst, year, month, calendar, renderer, first) {
var daysInMonth = calendar.daysInMonth(year, month);
var monthsToShow = inst.options.monthsToShow;
monthsToShow = ($.isArray(monthsToShow) ? monthsToShow : [1, monthsToShow]);
var fixedWeeks = inst.options.fixedWeeks || (monthsToShow[0] * monthsToShow[1] > 1);
var firstDay = inst.options.firstDay;
firstDay = (typeof firstDay === 'undefined' || firstDay === null ? calendar.local.firstDay : firstDay);
var leadDays = (calendar.dayOfWeek(year, month, calendar.minDay) -
firstDay + calendar.daysInWeek()) % calendar.daysInWeek();
var numWeeks = (fixedWeeks ? 6 : Math.ceil((leadDays + daysInMonth) / calendar.daysInWeek()));
var selectOtherMonths = inst.options.selectOtherMonths && inst.options.showOtherMonths;
var minDate = (inst.pickingRange ? inst.selectedDates[0] : inst.get('minDate'));
var maxDate = inst.get('maxDate');
var showWeeks = renderer.week.indexOf('{weekOfYear}') > -1;
var today = calendar.today();
var drawDate = calendar.newDate(year, month, calendar.minDay);
drawDate.add(-leadDays - (fixedWeeks &&
(drawDate.dayOfWeek() === firstDay || drawDate.daysInMonth() < calendar.daysInWeek())?
calendar.daysInWeek() : 0), 'd');
var jd = drawDate.toJD();
// Localise numbers if requested and available
var localiseNumbers = function(value) {
return (inst.options.localNumbers && calendar.local.digits ? calendar.local.digits(value) : value);
};
// Generate weeks
var weeks = '';
for (var week = 0; week < numWeeks; week++) {
var weekOfYear = (!showWeeks ? '' : '' +
($.isFunction(inst.options.calculateWeek) ?
inst.options.calculateWeek(drawDate) : drawDate.weekOfYear()) + '');
var days = '';
for (var day = 0; day < calendar.daysInWeek(); day++) {
var selected = false;
if (inst.options.rangeSelect && inst.selectedDates.length > 0) {
selected = drawDate.compareTo(inst.selectedDates[0]) !== -1 &&
drawDate.compareTo(inst.selectedDates[1]) !== +1;
}
else {
for (var i = 0; i < inst.selectedDates.length; i++) {
if (inst.selectedDates[i].compareTo(drawDate) === 0) {
selected = true;
break;
}
}
}
var dateInfo = (!$.isFunction(inst.options.onDate) ? {} :
inst.options.onDate.apply(elem, [drawDate, drawDate.month() === month]));
var selectable = (selectOtherMonths || drawDate.month() === month) &&
this._isSelectable(elem, drawDate, dateInfo.selectable, minDate, maxDate);
days += this._prepare(renderer.day, inst).replace(/\{day\}/g,
(selectable ? '' +
(inst.options.showOtherMonths || drawDate.month() === month ?
dateInfo.content || localiseNumbers(drawDate.day()) : ' ') +
(selectable ? '' : ''));
drawDate.add(1, 'd');
jd++;
}
weeks += this._prepare(renderer.week, inst).replace(/\{days\}/g, days).
replace(/\{weekOfYear\}/g, weekOfYear);
}
var monthHeader = this._prepare(renderer.month, inst).match(/\{monthHeader(:[^\}]+)?\}/);
monthHeader = (monthHeader[0].length <= 13 ? 'MM yyyy' :
monthHeader[0].substring(13, monthHeader[0].length - 1));
monthHeader = (first ? this._generateMonthSelection(
inst, year, month, minDate, maxDate, monthHeader, calendar, renderer) :
calendar.formatDate(monthHeader, calendar.newDate(year, month, calendar.minDay),
{localNumbers: inst.options.localNumbers}));
var weekHeader = this._prepare(renderer.weekHeader, inst).
replace(/\{days\}/g, this._generateDayHeaders(inst, calendar, renderer));
return this._prepare(renderer.month, inst).replace(/\{monthHeader(:[^\}]+)?\}/g, monthHeader).
replace(/\{weekHeader\}/g, weekHeader).replace(/\{weeks\}/g, weeks);
},
/** Generate the HTML for the day headers.
@memberof CalendarsPicker
@private
@param {object} inst The current instance settings.
@param {BaseCalendar} calendar The current calendar.
@param {object} renderer The rendering templates.
@return {string} A week's worth of day headers. */
_generateDayHeaders: function(inst, calendar, renderer) {
var firstDay = inst.options.firstDay;
firstDay = (typeof firstDay === 'undefined' || firstDay === null ? calendar.local.firstDay : firstDay);
var header = '';
for (var day = 0; day < calendar.daysInWeek(); day++) {
var dow = (day + firstDay) % calendar.daysInWeek();
header += this._prepare(renderer.dayHeader, inst).replace(/\{day\}/g,
'' + calendar.local.dayNamesMin[dow] + '');
}
return header;
},
/** Generate the selection controls for a month.
@memberof CalendarsPicker
@private
@param {object} inst The current instance settings.
@param {number} year The year to generate.
@param {number} month The month to generate.
@param {CDate} minDate The minimum date allowed.
@param {CDate} maxDate The maximum date allowed.
@param {string} monthHeader The month/year format.
@param {BaseCalendar} calendar The current calendar.
@return {string} The month selection content. */
_generateMonthSelection: function(inst, year, month, minDate, maxDate, monthHeader, calendar) {
if (!inst.options.changeMonth) {
return calendar.formatDate(monthHeader, calendar.newDate(year, month, 1),
{localNumbers: inst.options.localNumbers});
}
// Months
var monthNames = calendar.local[
'monthNames' + (monthHeader.match(/mm/i) ? '' : 'Short')];
var html = monthHeader.replace(/m+/i, '\\x2E').replace(/y+/i, '\\x2F');
var selector = '';
html = html.replace(/\\x2E/, selector);
// Years
var localiseNumbers = function(value) {
return (inst.options.localNumbers && calendar.local.digits ? calendar.local.digits(value) : value);
};
var yearRange = inst.options.yearRange;
if (yearRange === 'any') {
selector = '' +
'';
}
else {
yearRange = yearRange.split(':');
var todayYear = calendar.today().year();
var start = (yearRange[0].match('c[+-].*') ? year + parseInt(yearRange[0].substring(1), 10) :
((yearRange[0].match('[+-].*') ? todayYear : 0) + parseInt(yearRange[0], 10)));
var end = (yearRange[1].match('c[+-].*') ? year + parseInt(yearRange[1].substring(1), 10) :
((yearRange[1].match('[+-].*') ? todayYear : 0) + parseInt(yearRange[1], 10)));
selector = '';
}
html = html.replace(/\\x2F/, selector);
return html;
},
/** Prepare a render template for use.
Exclude popup/inline sections that are not applicable.
Localise text of the form: {l10n:name}.
@memberof CalendarsPicker
@private
@param {string} text The text to localise.
@param {object} inst The current instance settings.
@return {string} The localised text. */
_prepare: function(text, inst) {
var replaceSection = function(type, retain) {
while (true) {
var start = text.indexOf('{' + type + ':start}');
if (start === -1) {
return;
}
var end = text.substring(start).indexOf('{' + type + ':end}');
if (end > -1) {
text = text.substring(0, start) +
(retain ? text.substr(start + type.length + 8, end - type.length - 8) : '') +
text.substring(start + end + type.length + 6);
}
}
};
replaceSection('inline', inst.inline);
replaceSection('popup', !inst.inline);
var pattern = /\{l10n:([^\}]+)\}/;
var matches = pattern.exec(text);
while (matches) {
text = text.replace(matches[0], inst.options[matches[1]]);
matches = pattern.exec(text);
}
return text;
}
});
var plugin = $.calendarsPicker; // Singleton instance
$(function() {
$(document).on('mousedown.' + pluginName, plugin._checkExternalClick).
on('resize.' + pluginName, function() { plugin.hide(plugin.curInst); });
});
})(jQuery);