/* $Id: calendar-date-core.js 6805 2007-03-30 12:36:39Z slip $ */ /** * * Copyright (c) 2004-2006 by Zapatec, Inc. * http://www.zapatec.com * 1700 MLK Way, Berkeley, California, * 94709, U.S.A. * All rights reserved. */ // BEGIN: DATE OBJECT PATCHES /** \defgroup DateExtras Augmenting the Date object with some utility functions * and variables. */ //@{ Date._MD = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; /**< Number of days in each month */ Date.SECOND = 1000; /**< One second has 1000 milliseconds. */ Date.MINUTE = 60 * Date.SECOND; /**< One minute has 60 seconds. */ Date.HOUR = 60 * Date.MINUTE; /**< One hour has 60 minutes. */ Date.DAY = 24 * Date.HOUR; /**< One day has 24 hours. */ Date.WEEK = 7 * Date.DAY; /**< One week has 7 days. */ /** Returns the number of days in the month. The \em month parameter is * optional; if not passed, the current month of \b this Date object is * assumed. * * @param month [int, optional] the month number, 0 for January. */ 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._MD[month]; } }; /** Returns the number of the current day in the current 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.round(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 dates equality. Checks time too. */ 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())); }; /** Checks dates equality. Ignores time. */ Date.prototype.dateEqualsTo = function(date) { return ((this.getFullYear() == date.getFullYear()) && (this.getMonth() == date.getMonth()) && (this.getDate() == date.getDate())); }; /** 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. * * The format (\b str) may contain the following specialties: * * - %%a - Abbreviated weekday name * - %%A - Full weekday name * - %%b - Abbreviated month name * - %%B - Full month name * - %%C - Century number * - %%d - The day of the month (00 .. 31) * - %%e - The day of the month (0 .. 31) * - %%H - Hour (00 .. 23) * - %%I - Hour (01 .. 12) * - %%j - The day of the year (000 .. 366) * - %%k - Hour (0 .. 23) * - %%l - Hour (1 .. 12) * - %%m - Month (01 .. 12) * - %%M - Minute (00 .. 59) * - %%n - A newline character * - %%p - "PM" or "AM" * - %%P - "pm" or "am" * - %%S - Second (00 .. 59) * - %%s - Number of seconds since Epoch * - %%t - A tab character * - %%W - The week number (as per ISO 8601) * - %%u - The day of week (1 .. 7, 1 = Monday) * - %%w - The day of week (0 .. 6, 0 = Sunday) * - %%y - Year without the century (00 .. 99) * - %%Y - Year including the century (ex. 1979) * - %%% - A literal %% character * * They are almost the same as for the POSIX strftime function. * * @param str [string] the format to print date in. */ 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"] = Zapatec.Calendar.i18n(w, "sdn"); // abbreviated weekday name [FIXME: I18N] s["%A"] = Zapatec.Calendar.i18n(w, "dn"); // full weekday name s["%b"] = Zapatec.Calendar.i18n(m, "smn"); // abbreviated month name [FIXME: I18N] s["%B"] = Zapatec.Calendar.i18n(m, "mn"); // 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 ? hr : "0"; // 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 == 0) ? 7 : w; // the day of the week (range 1 to 7, 1 = MON) s["%w"] = w ? w : "0"; // 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 % 100; // year without the century (range 00 to 99) if (s["%y"] < 10) { s["%y"] = "0" + s["%y"]; } s["%Y"] = y; // year with the century s["%%"] = "%"; // a literal '%' character var re = /%./g; var a = str.match(re) || []; for (var i = 0; i < a.length; i++) { var tmp = s[a[i]]; if (tmp) { re = new RegExp(a[i], 'g'); str = str.replace(re, tmp); } } return str; }; /** * Parses a date from a string in the specified format. * This function requires strict following of the string to * the format template, and any difference causes failure * to be returned. Also function refuses to parse formats * which containing number rules that have not fixed length * and are not separated from the next number rule by any * character string, as this requires complication of algorythm * and still sometimes is impossible to parse. * * @param str [string] the date as a string * @param format [string] the format to try to parse the date in * * @return [Date] a date object containing the parsed date or \b null if for * some reason the date couldn't be parsed. */ Date.parseDate = function (str, format) { var fmt = format, strPointer = 0, token = null, parseFunc = null, valueLength = null, valueRange = null, valueType = null, date = new Date(), values = {}; //need to have a way to determine whether rule is number var numberRules = ["%d", "%H", "%I", "%m", "%M", "%S", "%s", "%W", "%u", "%w", "%y", "%e", "%k", "%l", "%s", "%Y", "%C"]; function isNumberRule(rule) { if (Zapatec.Utils.arrIndexOf(numberRules, rule) != -1) { return true; } return false; } //parses string value from translation table function parseString() { for(var iString = valueRange[0]; iString < valueRange[1]; ++iString) { //checking if there is translation var value = Zapatec.Calendar.i18n(iString, valueType); if (!value) { return null; } //comparing with our part of the string if (value == str.substr(strPointer, value.length)) { //increasing string pointer valueLength = value.length; return iString; } } return null; } //parses the number from beginning of string function parseNumber() { var val = str.substr(strPointer, valueLength); if (val.length != valueLength || /$\d+^/.test(val)) { return null; } return parseInt(val, 10); } //parses AM PM rule function parseAMPM() { var result = (str.substr(strPointer, valueLength).toLowerCase() == Zapatec.Calendar.i18n("pm", "ampm")) ? true : false; return result || ((str.substr(strPointer, valueLength).toLowerCase() == Zapatec.Calendar.i18n("am", "ampm")) ? false : null); } //parses formating character function parseCharacter() { return ""; } //parses the rule to the array function parseRule(rule) { return (values[rule] = parseFunc()); } //function determines if rule value was parsed function wasParsed(rule) { if (typeof rule == "undefined" || rule === null) { return false; } return true; } //gets first defined value or null if no function getValue() { for(var i = 0; i < arguments.length; ++i) { if (arguments[i] !== null && typeof arguments[i] != "undefined" && !isNaN(arguments[i])) { return arguments[i]; } } return null; } if (typeof fmt != "string" || typeof str != "string" || str == "" || fmt == "") { return null; } //cycle breaks format into tokens and checks or parses them while(fmt) { //this is the default value type parseFunc = parseNumber; //taking char token(that doesn't hold any information) valueLength = fmt.indexOf("%"); valueLength = (valueLength == -1) ? fmt.length : valueLength; token = fmt.slice(0, valueLength); //checking if we have same token in parsed string if (token != str.substr(strPointer, valueLength)) { return null; } //skiping it strPointer += valueLength; fmt = fmt.slice(valueLength); if (fmt == "") { break; } //taking formating rule token = fmt.slice(0, 2); //this is the default length of value, as it is very often one for rules valueLength = 2; switch (token) { case "%A" : case "%a" : { valueType = (token == "%A") ? "dn" : "sdn"; valueRange = [0, 7]; parseFunc = parseString; break; } case "%B" : case "%b" : { valueType = (token == "%B") ? "mn" : "smn"; valueRange = [0, 12]; parseFunc = parseString; break; } case "%p" : case "%P" : { parseFunc = parseAMPM; break; } case "%Y" : { valueLength = 4; if (isNumberRule(fmt.substr(2, 2))) { return null; } while(isNaN(parseInt(str.charAt(strPointer + valueLength - 1))) && valueLength > 0) { --valueLength; } if (valueLength == 0) {break;} break; } case "%C" : case "%s" : { valueLength = 1; if (isNumberRule(fmt.substr(2, 2))) { return null; } while(!isNaN(parseInt(str.charAt(strPointer + valueLength)))) { ++valueLength; } break; } case "%k" : case "%l" : case "%e" : { valueLength = 1; if (isNumberRule(fmt.substr(2, 2))) { return null; } if (!isNaN(parseInt(str.charAt(strPointer + 1)))) { ++valueLength; } break; } case "%j" : valueLength = 3; break; case "%u" : case "%w" : valueLength = 1; case "%y" : case "%m" : case "%d" : case "%W" : case "%H" : case "%I" : case "%M" : case "%S" : { break; } } if (parseRule(token) === null) { return null; } //increasing pointer strPointer += valueLength; //skipint it fmt = fmt.slice(2); } if (wasParsed(values["%s"])) { date.setTime(values["%s"] * 1000); } else { var year = getValue(values["%Y"], values["%y"] + --values["%C"] * 100, values["%y"] + (date.getFullYear() - date.getFullYear() % 100), values["%C"] * 100 + date.getFullYear() % 100); var month = getValue(values["%m"] - 1, values["%b"], values["%B"]); var day = getValue(values["%d"] || values["%e"]); if (day === null || month === null) { var dayOfWeek = getValue(values["%a"], values["%A"], values["%u"] == 7 ? 0 : values["%u"], values["%w"]); } var hour = getValue(values["%H"], values["%k"]); if (hour === null && (wasParsed(values["%p"]) || wasParsed(values["%P"]))) { var pm = getValue(values["%p"], values["%P"]); hour = getValue(values["%I"], values["%l"]); hour = pm ? ((hour == 12) ? 12 : (hour + 12)) : ((hour == 12) ? (0) : hour); } if (year || year === 0) { date.setFullYear(year); } if (month || month === 0) { date.setMonth(month); } if (day || day === 0) { date.setDate(day); } if (wasParsed(values["%j"])) { date.setMonth(0); date.setDate(1); date.setDate(values["%j"]); } if (wasParsed(dayOfWeek)) { date.setDate(date.getDate() + (dayOfWeek - date.getDay())); } if (wasParsed(values["%W"])) { var weekNumber = date.getWeekNumber(); if (weekNumber != values["%W"]) { date.setDate(date.getDate() + (values["%W"] - weekNumber) * 7); } } if (hour !== null) { date.setHours(hour); } if (wasParsed(values["%M"])) { date.setMinutes(values["%M"]); } if (wasParsed(values["%S"])) { date.setSeconds(values["%S"]); } } //printing date in the same format and checking if we'll get the same string if (date.print(format) != str) { //if not returning error return null; } //or returning parsed date return date; }; Date.prototype.__msh_oldSetFullYear = Date.prototype.setFullYear; /**< save a reference to the original setFullYear function */ /** * This function replaces the original Date.setFullYear() with a "safer" * function which makes sure that the month or date aren't modified (unless in * the exceptional case where the date is February 29 but the new year doesn't * contain it). * * @param y [int] the new year to move this date to */ 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); }; /** * This function compares only years, months and days of two date objects. * * @return [int] -1 if date1>date2, 1 if date2>date1 or 0 if they are equal * * @param date1 [Date] first date to compare * @param date1 [Date] second date to compare */ Date.prototype.compareDatesOnly = function (date1,date2) { var year1 = date1.getYear(); var year2 = date2.getYear(); var month1 = date1.getMonth(); var month2 = date2.getMonth(); var day1 = date1.getDate(); var day2 = date2.getDate(); if (year1 > year2) { return -1; } if (year2 > year1) { return 1; } //years are equal if (month1 > month2) { return -1; } if (month2 > month1) { return 1; } //years and months are equal if (day1 > day2) { return -1; } if (day2 > day1) { return 1; } //days are equal return 0; } //@} // END: DATE OBJECT PATCHES
