// // CalendarView (for Prototype) // calendarview.org // // Maintained by Justin Mecham // // Portions Copyright 2002-2005 Mihai Bazon // // This calendar is based very loosely on the Dynarch Calendar in that it was // used as a base, but completely gutted and more or less rewritten in place // to use the Prototype JavaScript library. // // As such, CalendarView is licensed under the terms of the GNU Lesser General // Public License (LGPL). More information on the Dynarch Calendar can be // found at: // // www.dynarch.com/projects/calendar // var Calendar = Class.create(); //------------------------------------------------------------------------------ // Constants //------------------------------------------------------------------------------ Calendar.VERSION = '1.2'; Calendar.DAY_NAMES = [ 'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday' ]; Calendar.SHORT_DAY_NAMES = [ 'S', 'M', 'T', 'W', 'T', 'F', 'S', 'S' ]; Calendar.MONTH_NAMES = [ 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December' ]; Calendar.SHORT_MONTH_NAMES = [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ]; Calendar.NAV_PREVIOUS_YEAR = -2; Calendar.NAV_PREVIOUS_MONTH = -1; Calendar.NAV_TODAY = 0; Calendar.NAV_NEXT_MONTH = 1; Calendar.NAV_NEXT_YEAR = 2; //------------------------------------------------------------------------------ // Static Methods //------------------------------------------------------------------------------ // This gets called when the user presses a mouse button anywhere in the // document, if the calendar is shown. If the click was outside the open // calendar this function closes it. Calendar._checkCalendar = function(event) { if (!window._popupCalendar){ return false; } if (Element.descendantOf(Event.element(event), window._popupCalendar.container)){ return; } window._popupCalendar.callCloseHandler(); return Event.stop(event); }; //------------------------------------------------------------------------------ // Event Handlers //------------------------------------------------------------------------------ Calendar.handleMouseDownEvent = function(event) { Event.observe(document, 'mouseup', Calendar.handleMouseUpEvent); Event.stop(event); }; // XXX I am not happy with how clicks of different actions are handled. Need to // clean this up! Calendar.handleMouseUpEvent = function(event) { var el = Event.element(event); var calendar = el.calendar; var isNewDate = false; // If the element that was clicked on does not have an associated Calendar // object, return as we have nothing to do. if (!calendar) { return false; } // Clicked on a day if (typeof el.navAction == 'undefined') { if (calendar.currentDateElement) { Element.removeClassName(calendar.currentDateElement, 'selected'); Element.addClassName(el, 'selected'); calendar.shouldClose = (calendar.currentDateElement == el); if (!calendar.shouldClose) { calendar.currentDateElement = el; } } calendar.date.setDateOnly(el.date); isNewDate = true; calendar.shouldClose = !el.hasClassName('otherDay'); var isOtherMonth = !calendar.shouldClose; if (isOtherMonth) { calendar.update(calendar.date); } } // Clicked on an action button else { var date = new Date(calendar.date); if (el.navAction == Calendar.NAV_TODAY){ date.setDateOnly(new Date()); } var year = date.getFullYear(); var mon = date.getMonth(); function setMonth(m) { var day = date.getDate(); var max = date.getMonthDays(m); if (day > max) { date.setDate(max); } date.setMonth(m); } switch (el.navAction) { // Previous Year case Calendar.NAV_PREVIOUS_YEAR: if (year > calendar.minYear){ date.setFullYear(year - 1); } break; // Previous Month case Calendar.NAV_PREVIOUS_MONTH: if (mon > 0) { setMonth(mon - 1); } else if (year-- > calendar.minYear) { date.setFullYear(year); setMonth(11); } break; // Today case Calendar.NAV_TODAY: break; // Next Month case Calendar.NAV_NEXT_MONTH: if (mon < 11) { setMonth(mon + 1); } else if (year < calendar.maxYear) { date.setFullYear(year + 1); setMonth(0); } break; // Next Year case Calendar.NAV_NEXT_YEAR: if (year < calendar.maxYear){ date.setFullYear(year + 1); } break; } if (!date.equalsTo(calendar.date)) { calendar.setDate(date); isNewDate = true; } else if (el.navAction === 0) { isNewDate = (calendar.shouldClose = true); } } if (isNewDate) { event && calendar.callSelectHandler(); } if (calendar.shouldClose) { event && calendar.callCloseHandler(); } Event.stopObserving(document, 'mouseup', Calendar.handleMouseUpEvent); return Event.stop(event); }; Calendar.defaultSelectHandler = function(calendar) { if (!calendar.dateField) { return false; } // Update dateField value if (calendar.dateField.tagName == 'DIV') { Element.update(calendar.dateField, calendar.date.print(calendar.dateFormat)); } else if (calendar.dateField.tagName == 'INPUT') { calendar.dateField.value = calendar.date.print(calendar.dateFormat); } // Trigger the onchange callback on the dateField, if one has been defined if (typeof calendar.dateField.onchange == 'function'){ calendar.dateField.onchange(); } // Call the close handler, if necessary if (calendar.shouldClose) { calendar.callCloseHandler(); } }; Calendar.defaultCloseHandler = function(calendar) { calendar.hide(); }; //------------------------------------------------------------------------------ // Calendar Setup //------------------------------------------------------------------------------ Calendar.setup = function(params) { function param_default(name, def) { if (!params[name]) { params[name] = def; } } param_default('dateField', null); param_default('triggerElement', null); param_default('parentElement', null); param_default('selectHandler', null); param_default('closeHandler', null); // In-Page Calendar if (params.parentElement) { var calendar = new Calendar(params.parentElement); calendar.setSelectHandler(params.selectHandler || Calendar.defaultSelectHandler); if (params.dateFormat){ calendar.setDateFormat(params.dateFormat); } if (params.dateField) { calendar.setDateField(params.dateField); calendar.parseDate(calendar.dateField.innerHTML || calendar.dateField.value); } calendar.show(); return calendar; } // Popup Calendars // // XXX There is significant optimization to be had here by creating the // calendar and storing it on the page, but then you will have issues with // multiple calendars on the same page. else { var triggerElement = $(params.triggerElement || params.dateField); triggerElement.onclick = function() { var calendar = new Calendar(); calendar.setSelectHandler(params.selectHandler || Calendar.defaultSelectHandler); calendar.setCloseHandler(params.closeHandler || Calendar.defaultCloseHandler); if (params.dateFormat){ calendar.setDateFormat(params.dateFormat); } if (params.dateField) { calendar.setDateField(params.dateField); calendar.parseDate(calendar.dateField.innerHTML || calendar.dateField.value); } if (params.dateField){ Date.parseDate(calendar.dateField.value || calendar.dateField.innerHTML, calendar.dateFormat); } calendar.showAtElement(triggerElement); return calendar; }; } }; //------------------------------------------------------------------------------ // Calendar Instance //------------------------------------------------------------------------------ Calendar.prototype = { // The HTML Container Element container: null, // Callbacks selectHandler: null, closeHandler: null, // Configuration minYear: 1900, maxYear: 2100, dateFormat: '%Y-%m-%d', // Dates date: new Date(), currentDateElement: null, // Status shouldClose: false, isPopup: true, dateField: null, //---------------------------------------------------------------------------- // Initialize //---------------------------------------------------------------------------- initialize: function(parent) { if (parent){ this.create($(parent)); } else{ this.create(); } }, //---------------------------------------------------------------------------- // Update / (Re)initialize Calendar //---------------------------------------------------------------------------- update: function(date) { var calendar = this; var today = new Date(); var thisYear = today.getFullYear(); var thisMonth = today.getMonth(); var thisDay = today.getDate(); var month = date.getMonth(); var dayOfMonth = date.getDate(); // Ensure date is within the defined range if (date.getFullYear() < this.minYear){ date.setFullYear(this.minYear); } else if (date.getFullYear() > this.maxYear){ date.setFullYear(this.maxYear); } this.date = new Date(date); // Calculate the first day to display (including the previous month) date.setDate(1); date.setDate(-(date.getDay()) + 2); // Fill in the days of the month Element.getElementsBySelector(this.container, 'tbody tr').each( function(row, i) { var rowHasDays = false; row.immediateDescendants().each( function(cell, j) { var day = date.getDate(); var dayOfWeek = date.getDay(); var isCurrentMonth = (date.getMonth() == month); // Reset classes on the cell cell.className = ''; cell.date = new Date(date); cell.update(day); // Account for days of the month other than the current month if (!isCurrentMonth){ cell.addClassName('otherDay'); } else{ rowHasDays = true; } // Ensure the current day is selected if (isCurrentMonth && day == dayOfMonth) { cell.addClassName('selected'); calendar.currentDateElement = cell; } // Today if (date.getFullYear() == thisYear && date.getMonth() == thisMonth && day == thisDay){ cell.addClassName('today'); } // Weekend if ([0, 6].indexOf(dayOfWeek) != -1){ cell.addClassName('weekend'); } // Set the date to tommorrow date.setDate(day + 1); } ); // Hide the extra row if it contains only days from another month rowHasDays ? row.show() : row.hide(); } ); this.container.getElementsBySelector('td.title')[0].update( Calendar.MONTH_NAMES[month] + ' ' + this.date.getFullYear() ); }, //---------------------------------------------------------------------------- // Create/Draw the Calendar HTML Elements //---------------------------------------------------------------------------- create: function(parent) { // If no parent was specified, assume that we are creating a popup calendar. if (!parent) { parent = document.getElementsByTagName('body')[0]; this.isPopup = true; } else { this.isPopup = false; } // Calendar Table var table = new Element('table'); // Calendar Header var thead = new Element('thead'); table.appendChild(thead); // Title Placeholder var row = new Element('tr'); var cell = new Element('td', { colSpan: 7 } ); cell.addClassName('title'); row.appendChild(cell); thead.appendChild(row); // Calendar Navigation row = new Element('tr'); this._drawButtonCell(row, '«', 1, Calendar.NAV_PREVIOUS_YEAR); this._drawButtonCell(row, '‹', 1, Calendar.NAV_PREVIOUS_MONTH); this._drawButtonCell(row, 'Today', 3, Calendar.NAV_TODAY); this._drawButtonCell(row, '›', 1, Calendar.NAV_NEXT_MONTH); this._drawButtonCell(row, '»', 1, Calendar.NAV_NEXT_YEAR); thead.appendChild(row); // Day Names row = new Element('tr'); for (var i = 1; i < 8; ++i) { cell = new Element('th').update(Calendar.SHORT_DAY_NAMES[i]); if (i === 0 || i == 6){ cell.addClassName('weekend'); } row.appendChild(cell); } thead.appendChild(row); // Calendar Days var tbody = table.appendChild(new Element('tbody')); for (i = 6; i > 0; --i) { row = tbody.appendChild(new Element('tr')); row.addClassName('days'); for (var j = 7; j > 0; --j) { cell = row.appendChild(new Element('td')); cell.calendar = this; } } // Calendar Container (div) this.container = new Element('div'); this.container.addClassName('calendar'); if (this.isPopup) { this.container.setStyle({ position: 'absolute', display: 'none' }); this.container.addClassName('popup'); } this.container.appendChild(table); // Initialize Calendar this.update(this.date); // Observe the container for mousedown events Event.observe(this.container, 'mousedown', Calendar.handleMouseDownEvent); // Append to parent element parent.appendChild(this.container); }, _drawButtonCell: function(parent, text, colSpan, navAction) { var cell = new Element('td'); if (colSpan > 1) { cell.colSpan = colSpan; } cell.className = 'button'; cell.calendar = this; cell.navAction = navAction; cell.innerHTML = text; cell.unselectable = 'on'; // IE parent.appendChild(cell); return cell; }, //------------------------------------------------------------------------------ // Callbacks //------------------------------------------------------------------------------ // Calls the Select Handler (if defined) callSelectHandler: function() { if (this.selectHandler){ this.selectHandler(this, this.date.print(this.dateFormat)); } }, // Calls the Close Handler (if defined) callCloseHandler: function() { if (this.closeHandler){ this.closeHandler(this); } }, //------------------------------------------------------------------------------ // Calendar Display Functions //------------------------------------------------------------------------------ // Shows the Calendar show: function() { this.container.show(); if (this.isPopup) { window._popupCalendar = this; Event.observe(document, 'mousedown', Calendar._checkCalendar); } }, // Shows the calendar at the given absolute position showAt: function (x, y) { this.container.setStyle({ left: x + 'px', top: y + 'px' }); this.show(); }, // Shows the Calendar at the coordinates of the provided element showAtElement: function(element) { var pos = Position.cumulativeOffset(element); this.showAt((pos[0]-140 < 0? 50 : pos[0]-140), (pos[1]+130 < 0? 50 : pos[1]+130)); }, // Hides the Calendar hide: function() { if (this.isPopup){ Event.stopObserving(document, 'mousedown', Calendar._checkCalendar); } this.container.hide(); }, //------------------------------------------------------------------------------ // Miscellaneous //------------------------------------------------------------------------------ // Tries to identify the date represented in a string. If successful it also // calls this.setDate which moves the calendar to the given date. parseDate: function(str, format) { if (!format){ format = this.dateFormat; } this.setDate(Date.parseDate(str, format)); }, //------------------------------------------------------------------------------ // Getters/Setters //------------------------------------------------------------------------------ setSelectHandler: function(selectHandler) { this.selectHandler = selectHandler; }, setCloseHandler: function(closeHandler) { this.closeHandler = closeHandler; }, setDate: function(date) { if (!date.equalsTo(this.date)){ this.update(date); } }, setDateFormat: function(format) { this.dateFormat = format; }, setDateField: function(field) { this.dateField = $(field); }, setRange: function(minYear, maxYear) { this.minYear = minYear; this.maxYear = maxYear; } }; // global object that remembers the calendar window._popupCalendar = null; //============================================================================== // // Date Object Patches // // This is pretty much untouched from the original. I really would like to get // rid of these patches if at all possible and find a cleaner way of // accomplishing the same things. It's a shame Prototype doesn't extend Date at // all. // //============================================================================== Date.DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; Date.SECOND = 1000; /* milliseconds */ Date.MINUTE = 60 * Date.SECOND; Date.HOUR = 60 * Date.MINUTE; Date.DAY = 24 * Date.HOUR; Date.WEEK = 7 * Date.DAY; // Parses Date Date.parseDate = function(str, fmt) { var today = new Date(); var y = 0; var m = -1; var d = 0; var a = str.split(/\W+/); var b = fmt.match(/%./g); var i = 0, j = 0; var hr = 0; var min = 0; for (i = 0; i < a.length; ++i) { if (!a[i]) { continue; } switch (b[i]) { case "%d": case "%e": d = parseInt(a[i], 10); break; case "%m": m = parseInt(a[i], 10) - 1; break; case "%Y": case "%y": y = parseInt(a[i], 10); (y < 100) && (y += (y > 29) ? 1900 : 2000); break; case "%b": case "%B": for (j = 0; j < 12; ++j) { if (Calendar.MONTH_NAMES[j].substr(0, a[i].length).toLowerCase() == a[i].toLowerCase()) { m = j; break; } } break; case "%H": case "%I": case "%k": case "%l": hr = parseInt(a[i], 10); break; case "%P": case "%p": if (/pm/i.test(a[i]) && hr < 12){ hr += 12; } else if (/am/i.test(a[i]) && hr >= 12){ hr -= 12; } break; case "%M": min = parseInt(a[i], 10); break; } } if (isNaN(y)) { y = today.getFullYear(); } if (isNaN(m)) { m = today.getMonth(); } if (isNaN(d)) { d = today.getDate(); } if (isNaN(hr)) { hr = today.getHours(); } if (isNaN(min)) { min = today.getMinutes(); } if (y != 0 && m != -1 && d != 0){ return new Date(y, m, d, hr, min, 0); } y = 0; m = -1; d = 0; for (i = 0; i < a.length; ++i) { if (a[i].search(/[a-zA-Z]+/) != -1) { var t = -1; for (j = 0; j < 12; ++j) { if (Calendar.MONTH_NAMES[j].substr(0, a[i].length).toLowerCase() == a[i].toLowerCase()) { t = j; break; } } if (t != -1) { if (m != -1) { d = m+1; } m = t; } } else if (parseInt(a[i], 10) <= 12 && m == -1) { m = a[i]-1; } else if (parseInt(a[i], 10) > 31 && y == 0) { y = parseInt(a[i], 10); (y < 100) && (y += (y > 29) ? 1900 : 2000); } else if (d == 0) { d = a[i]; } } if (y == 0){ y = today.getFullYear(); } if (m != -1 && d != 0){ return new Date(y, m, d, hr, min, 0); } return today; }; // Returns the number of days in the current month Date.prototype.getMonthDays = function(month) { var year = this.getFullYear(); if (typeof month == "undefined"){ month = this.getMonth(); } if (((0 == (year % 4)) && ( (0 != (year % 100)) || (0 == (year % 400)))) && month == 1){ return 29; } else{ return Date.DAYS_IN_MONTH[month]; } }; // Returns the number of day in the year Date.prototype.getDayOfYear = function() { var now = new Date(this.getFullYear(), this.getMonth(), this.getDate(), 0, 0, 0); var then = new Date(this.getFullYear(), 0, 0, 0, 0, 0); var time = now - then; return Math.floor(time / Date.DAY); }; /** Returns the number of the week in year, as defined in ISO 8601. */ Date.prototype.getWeekNumber = function() { var d = new Date(this.getFullYear(), this.getMonth(), this.getDate(), 0, 0, 0); var DoW = d.getDay(); d.setDate(d.getDate() - (DoW + 6) % 7 + 3); // Nearest Thu var ms = d.valueOf(); // GMT d.setMonth(0); d.setDate(4); // Thu in Week 1 return Math.round((ms - d.valueOf()) / (7 * 864e5)) + 1; }; /** Checks date and time equality */ Date.prototype.equalsTo = function(date) { return ((this.getFullYear() == date.getFullYear()) && (this.getMonth() == date.getMonth()) && (this.getDate() == date.getDate()) && (this.getHours() == date.getHours()) && (this.getMinutes() == date.getMinutes())); }; /** Set only the year, month, date parts (keep existing time) */ Date.prototype.setDateOnly = function(date) { var tmp = new Date(date); this.setDate(1); this.setFullYear(tmp.getFullYear()); this.setMonth(tmp.getMonth()); this.setDate(tmp.getDate()); }; /** Prints the date in a string according to the given format. */ Date.prototype.print = function (str) { var m = this.getMonth(); var d = this.getDate(); var y = this.getFullYear(); var wn = this.getWeekNumber(); var w = this.getDay(); var s = {}; var hr = this.getHours(); var pm = (hr >= 12); var ir = (pm) ? (hr - 12) : hr; var dy = this.getDayOfYear(); if (ir == 0){ ir = 12; } var min = this.getMinutes(); var sec = this.getSeconds(); s["%a"] = Calendar.SHORT_DAY_NAMES[w]; // abbreviated weekday name [FIXME: I18N] s["%A"] = Calendar.DAY_NAMES[w]; // full weekday name s["%b"] = Calendar.SHORT_MONTH_NAMES[m]; // abbreviated month name [FIXME: I18N] s["%B"] = Calendar.MONTH_NAMES[m]; // full month name // FIXME: %c : preferred date and time representation for the current locale s["%C"] = 1 + Math.floor(y / 100); // the century number s["%d"] = (d < 10) ? ("0" + d) : d; // the day of the month (range 01 to 31) s["%e"] = d; // the day of the month (range 1 to 31) // FIXME: %D : american date style: %m/%d/%y // FIXME: %E, %F, %G, %g, %h (man strftime) s["%H"] = (hr < 10) ? ("0" + hr) : hr; // hour, range 00 to 23 (24h format) s["%I"] = (ir < 10) ? ("0" + ir) : ir; // hour, range 01 to 12 (12h format) s["%j"] = (dy < 100) ? ((dy < 10) ? ("00" + dy) : ("0" + dy)) : dy; // day of the year (range 001 to 366) s["%k"] = hr; // hour, range 0 to 23 (24h format) s["%l"] = ir; // hour, range 1 to 12 (12h format) s["%m"] = (m < 9) ? ("0" + (1+m)) : (1+m); // month, range 01 to 12 s["%M"] = (min < 10) ? ("0" + min) : min; // minute, range 00 to 59 s["%n"] = "\n"; // a newline character s["%p"] = pm ? "PM" : "AM"; s["%P"] = pm ? "pm" : "am"; // FIXME: %r : the time in am/pm notation %I:%M:%S %p // FIXME: %R : the time in 24-hour notation %H:%M s["%s"] = Math.floor(this.getTime() / 1000); s["%S"] = (sec < 10) ? ("0" + sec) : sec; // seconds, range 00 to 59 s["%t"] = "\t"; // a tab character // FIXME: %T : the time in 24-hour notation (%H:%M:%S) s["%U"] = s["%W"] = s["%V"] = (wn < 10) ? ("0" + wn) : wn; s["%u"] = w + 1; // the day of the week (range 1 to 7, 1 = MON) s["%w"] = w; // the day of the week (range 0 to 6, 0 = SUN) // FIXME: %x : preferred date representation for the current locale without the time // FIXME: %X : preferred time representation for the current locale without the date s["%y"] = ('' + y).substr(2, 2); // year without the century (range 00 to 99) s["%Y"] = y; // year with the century s["%%"] = "%"; // a literal '%' character return str.gsub(/%./, function(match) { return s[match] || match; }); }; Date.prototype.__msh_oldSetFullYear = Date.prototype.setFullYear; Date.prototype.setFullYear = function(y) { var d = new Date(this); d.__msh_oldSetFullYear(y); if (d.getMonth() != this.getMonth()){ this.setDate(28); } this.__msh_oldSetFullYear(y); };