Blame | Last modification | View Log | RSS feed
if(!dojo._hasResource["dojo.date.locale"]){ //_hasResource checks added by build. Do not use _hasResource directly in your code.dojo._hasResource["dojo.date.locale"] = true;dojo.provide("dojo.date.locale");// Localization methods for Date. Honor local customs using locale-dependent dojo.cldr data.dojo.require("dojo.date");dojo.require("dojo.cldr.supplemental");dojo.require("dojo.regexp");dojo.require("dojo.string");dojo.require("dojo.i18n");// Load the bundles containing localization information for// names and formatsdojo.requireLocalization("dojo.cldr", "gregorian", null, "ko,zh-cn,zh,ja,en,it-it,en-ca,en-au,it,en-gb,es-es,fr,pt,ROOT,ko-kr,es,de,pt-br");//NOTE: Everything in this module assumes Gregorian calendars.// Other calendars will be implemented in separate modules.(function(){// Format a pattern without literalsfunction formatPattern(dateObject, bundle, pattern){return pattern.replace(/([a-z])\1*/ig, function(match){var s;var c = match.charAt(0);var l = match.length;var pad;var widthList = ["abbr", "wide", "narrow"];switch(c){case 'G':s = bundle[(l < 4) ? "eraAbbr" : "eraNames"][dateObject.getFullYear() < 0 ? 0 : 1];break;case 'y':s = dateObject.getFullYear();switch(l){case 1:break;case 2:s = String(s); s = s.substr(s.length - 2);break;default:pad = true;}break;case 'Q':case 'q':s = Math.ceil((dateObject.getMonth()+1)/3);// switch(l){// case 1: case 2:pad = true;// break;// case 3: case 4: // unimplemented// }break;case 'M':case 'L':var m = dateObject.getMonth();var width;switch(l){case 1: case 2:s = m+1; pad = true;break;case 3: case 4: case 5:width = widthList[l-3];break;}if(width){var type = (c == "L") ? "standalone" : "format";var prop = ["months",type,width].join("-");s = bundle[prop][m];}break;case 'w':var firstDay = 0;s = dojo.date.locale._getWeekOfYear(dateObject, firstDay); pad = true;break;case 'd':s = dateObject.getDate(); pad = true;break;case 'D':s = dojo.date.locale._getDayOfYear(dateObject); pad = true;break;case 'E':case 'e':case 'c': // REVIEW: don't see this in the spec?var d = dateObject.getDay();var width;switch(l){case 1: case 2:if(c == 'e'){var first = dojo.cldr.supplemental.getFirstDayOfWeek(options.locale);d = (d-first+7)%7;}if(c != 'c'){s = d+1; pad = true;break;}// else fallthrough...case 3: case 4: case 5:width = widthList[l-3];break;}if(width){var type = (c == "c") ? "standalone" : "format";var prop = ["days",type,width].join("-");s = bundle[prop][d];}break;case 'a':var timePeriod = (dateObject.getHours() < 12) ? 'am' : 'pm';s = bundle[timePeriod];break;case 'h':case 'H':case 'K':case 'k':var h = dateObject.getHours();// strange choices in the date format make it impossible to write this succinctlyswitch (c) {case 'h': // 1-12s = (h % 12) || 12;break;case 'H': // 0-23s = h;break;case 'K': // 0-11s = (h % 12);break;case 'k': // 1-24s = h || 24;break;}pad = true;break;case 'm':s = dateObject.getMinutes(); pad = true;break;case 's':s = dateObject.getSeconds(); pad = true;break;case 'S':s = Math.round(dateObject.getMilliseconds() * Math.pow(10, l-3));break;case 'v': // FIXME: don't know what this is. seems to be same as z?case 'z':// We only have one timezone to offer; the one from the browsers = dojo.date.getTimezoneName(dateObject);if(s){break;}l=4;// fallthrough... use GMT if tz not availablecase 'Z':var offset = dateObject.getTimezoneOffset();var tz = [(offset<=0 ? "+" : "-"),dojo.string.pad(Math.floor(Math.abs(offset)/60), 2),dojo.string.pad(Math.abs(offset)% 60, 2)];if(l==4){tz.splice(0, 0, "GMT");tz.splice(3, 0, ":");}s = tz.join("");break;// case 'Y': case 'u': case 'W': case 'F': case 'g': case 'A':// console.debug(match+" modifier unimplemented");default:throw new Error("dojo.date.locale.format: invalid pattern char: "+pattern);}if(pad){ s = dojo.string.pad(s, l); }return s;});}dojo.date.locale.format = function(/*Date*/dateObject, /*Object?*/options){// summary:// Format a Date object as a String, using locale-specific settings.//// description:// Create a string from a Date object using a known localized pattern.// By default, this method formats both date and time from dateObject.// Formatting patterns are chosen appropriate to the locale. Different// formatting lengths may be chosen, with "full" used by default.// Custom patterns may be used or registered with translations using// the addCustomFormats method.// Formatting patterns are implemented using the syntax described at// http://www.unicode.org/reports/tr35/tr35-4.html#Date_Format_Patterns//// dateObject:// the date and/or time to be formatted. If a time only is formatted,// the values in the year, month, and day fields are irrelevant. The// opposite is true when formatting only dates.//// options: object {selector: string, formatLength: string, datePattern: string, timePattern: string, locale: string}// selector- choice of 'time','date' (default: date and time)// formatLength- choice of long, short, medium or full (plus any custom additions). Defaults to 'short'// datePattern,timePattern- override pattern with this string// am,pm- override strings for am/pm in times// locale- override the locale used to determine formatting rulesoptions = options || {};var locale = dojo.i18n.normalizeLocale(options.locale);var formatLength = options.formatLength || 'short';var bundle = dojo.date.locale._getGregorianBundle(locale);var str = [];var sauce = dojo.hitch(this, formatPattern, dateObject, bundle);if(options.selector == "year"){// Special case as this is not yet driven by CLDR datavar year = dateObject.getFullYear();if(locale.match(/^zh|^ja/)){year += "\u5E74";}return year;}if(options.selector != "time"){var datePattern = options.datePattern || bundle["dateFormat-"+formatLength];if(datePattern){str.push(_processPattern(datePattern, sauce));}}if(options.selector != "date"){var timePattern = options.timePattern || bundle["timeFormat-"+formatLength];if(timePattern){str.push(_processPattern(timePattern, sauce));}}var result = str.join(" "); //TODO: use locale-specific pattern to assemble date + timereturn result; // String};dojo.date.locale.regexp = function(/*Object?*/options){// summary:// Builds the regular needed to parse a localized date//// options: object {selector: string, formatLength: string, datePattern: string, timePattern: string, locale: string, strict: boolean}// selector- choice of 'time', 'date' (default: date and time)// formatLength- choice of long, short, medium or full (plus any custom additions). Defaults to 'short'// datePattern,timePattern- override pattern with this string// locale- override the locale used to determine formatting rulesreturn dojo.date.locale._parseInfo(options).regexp; // String};dojo.date.locale._parseInfo = function(/*Object?*/options){options = options || {};var locale = dojo.i18n.normalizeLocale(options.locale);var bundle = dojo.date.locale._getGregorianBundle(locale);var formatLength = options.formatLength || 'short';var datePattern = options.datePattern || bundle["dateFormat-" + formatLength];var timePattern = options.timePattern || bundle["timeFormat-" + formatLength];var pattern;if(options.selector == 'date'){pattern = datePattern;}else if(options.selector == 'time'){pattern = timePattern;}else{pattern = datePattern + ' ' + timePattern; //TODO: use locale-specific pattern to assemble date + time}var tokens = [];var re = _processPattern(pattern, dojo.hitch(this, _buildDateTimeRE, tokens, bundle, options));return {regexp: re, tokens: tokens, bundle: bundle};};dojo.date.locale.parse = function(/*String*/value, /*Object?*/options){// summary:// Convert a properly formatted string to a primitive Date object,// using locale-specific settings.//// description:// Create a Date object from a string using a known localized pattern.// By default, this method parses looking for both date and time in the string.// Formatting patterns are chosen appropriate to the locale. Different// formatting lengths may be chosen, with "full" used by default.// Custom patterns may be used or registered with translations using// the addCustomFormats method.// Formatting patterns are implemented using the syntax described at// http://www.unicode.org/reports/tr35/#Date_Format_Patterns//// value:// A string representation of a date//// options: object {selector: string, formatLength: string, datePattern: string, timePattern: string, locale: string, strict: boolean}// selector- choice of 'time', 'date' (default: date and time)// formatLength- choice of long, short, medium or full (plus any custom additions). Defaults to 'short'// datePattern,timePattern- override pattern with this string// am,pm- override strings for am/pm in times// locale- override the locale used to determine formatting rules// strict- strict parsing, off by defaultvar info = dojo.date.locale._parseInfo(options);var tokens = info.tokens, bundle = info.bundle;var re = new RegExp("^" + info.regexp + "$");var match = re.exec(value);if(!match){ return null; } // nullvar widthList = ['abbr', 'wide', 'narrow'];//1972 is a leap year. We want to avoid Feb 29 rolling over into Mar 1,//in the cases where the year is parsed after the month and day.var result = new Date(1972, 0);var expected = {};var amPm = "";dojo.forEach(match, function(v, i){if(!i){return;}var token=tokens[i-1];var l=token.length;switch(token.charAt(0)){case 'y':if(l != 2){//interpret year literally, so '5' would be 5 A.D.result.setFullYear(v);expected.year = v;}else{if(v<100){v = Number(v);//choose century to apply, according to a sliding window//of 80 years before and 20 years after present yearvar year = '' + new Date().getFullYear();var century = year.substring(0, 2) * 100;var yearPart = Number(year.substring(2, 4));var cutoff = Math.min(yearPart + 20, 99);var num = (v < cutoff) ? century + v : century - 100 + v;result.setFullYear(num);expected.year = num;}else{//we expected 2 digits and got more...if(options.strict){return null;}//interpret literally, so '150' would be 150 A.D.//also tolerate '1950', if 'yyyy' input passed to 'yy' formatresult.setFullYear(v);expected.year = v;}}break;case 'M':if(l>2){var months = bundle['months-format-' + widthList[l-3]].concat();if(!options.strict){//Tolerate abbreviating period in month part//Case-insensitive comparisonv = v.replace(".","").toLowerCase();months = dojo.map(months, function(s){ return s.replace(".","").toLowerCase(); } );}v = dojo.indexOf(months, v);if(v == -1){// console.debug("dojo.date.locale.parse: Could not parse month name: '" + v + "'.");return null;}}else{v--;}result.setMonth(v);expected.month = v;break;case 'E':case 'e':var days = bundle['days-format-' + widthList[l-3]].concat();if(!options.strict){//Case-insensitive comparisonv = v.toLowerCase();days = dojo.map(days, "".toLowerCase);}v = dojo.indexOf(days, v);if(v == -1){// console.debug("dojo.date.locale.parse: Could not parse weekday name: '" + v + "'.");return null;}//TODO: not sure what to actually do with this input,//in terms of setting something on the Date obj...?//without more context, can't affect the actual date//TODO: just validate?break;case 'd':result.setDate(v);expected.date = v;break;case 'D'://FIXME: need to defer this until after the year is set for leap-year?result.setMonth(0);result.setDate(v);break;case 'a': //am/pmvar am = options.am || bundle.am;var pm = options.pm || bundle.pm;if(!options.strict){var period = /\./g;v = v.replace(period,'').toLowerCase();am = am.replace(period,'').toLowerCase();pm = pm.replace(period,'').toLowerCase();}if(options.strict && v != am && v != pm){// console.debug("dojo.date.locale.parse: Could not parse am/pm part.");return null;}// we might not have seen the hours field yet, so store the state and apply hour change lateramPm = (v == pm) ? 'p' : (v == am) ? 'a' : '';break;case 'K': //hour (1-24)if(v==24){v=0;}// fallthrough...case 'h': //hour (1-12)case 'H': //hour (0-23)case 'k': //hour (0-11)//TODO: strict bounds checking, paddingif(v > 23){// console.debug("dojo.date.locale.parse: Illegal hours value");return null;}//in the 12-hour case, adjusting for am/pm requires the 'a' part//which could come before or after the hour, so we will adjust laterresult.setHours(v);break;case 'm': //minutesresult.setMinutes(v);break;case 's': //secondsresult.setSeconds(v);break;case 'S': //millisecondsresult.setMilliseconds(v);// break;// case 'w'://TODO var firstDay = 0;// default://TODO: throw?// console.debug("dojo.date.locale.parse: unsupported pattern char=" + token.charAt(0));}});var hours = result.getHours();if(amPm === 'p' && hours < 12){result.setHours(hours + 12); //e.g., 3pm -> 15}else if(amPm === 'a' && hours == 12){result.setHours(0); //12am -> 0}//validate parse date fields versus input date fieldsif(expected.year && result.getFullYear() != expected.year){// console.debug("dojo.date.locale.parse: Parsed year: '" + result.getFullYear() + "' did not match input year: '" + expected.year + "'.");return null;}if(expected.month && result.getMonth() != expected.month){// console.debug("dojo.date.locale.parse: Parsed month: '" + result.getMonth() + "' did not match input month: '" + expected.month + "'.");return null;}if(expected.date && result.getDate() != expected.date){// console.debug("dojo.date.locale.parse: Parsed day of month: '" + result.getDate() + "' did not match input day of month: '" + expected.date + "'.");return null;}//TODO: implement a getWeekday() method in order to test//validity of input strings containing 'EEE' or 'EEEE'...return result; // Date};function _processPattern(pattern, applyPattern, applyLiteral, applyAll){//summary: Process a pattern with literals in it// Break up on single quotes, treat every other one as a literal, except '' which becomes 'var identity = function(x){return x;};applyPattern = applyPattern || identity;applyLiteral = applyLiteral || identity;applyAll = applyAll || identity;//split on single quotes (which escape literals in date format strings)//but preserve escaped single quotes (e.g., o''clock)var chunks = pattern.match(/(''|[^'])+/g);var literal = false;dojo.forEach(chunks, function(chunk, i){if(!chunk){chunks[i]='';}else{chunks[i]=(literal ? applyLiteral : applyPattern)(chunk);literal = !literal;}});return applyAll(chunks.join(''));}function _buildDateTimeRE(tokens, bundle, options, pattern){pattern = dojo.regexp.escapeString(pattern);if(!options.strict){ pattern = pattern.replace(" a", " ?a"); } // kludge to tolerate no space before am/pmreturn pattern.replace(/([a-z])\1*/ig, function(match){// Build a simple regexp. Avoid captures, which would ruin the tokens listvar s;var c = match.charAt(0);var l = match.length;var p2 = '', p3 = '';if(options.strict){if(l > 1){ p2 = '0' + '{'+(l-1)+'}'; }if(l > 2){ p3 = '0' + '{'+(l-2)+'}'; }}else{p2 = '0?'; p3 = '0{0,2}';}switch(c){case 'y':s = '\\d{2,4}';break;case 'M':s = (l>2) ? '\\S+' : p2+'[1-9]|1[0-2]';break;case 'D':s = p2+'[1-9]|'+p3+'[1-9][0-9]|[12][0-9][0-9]|3[0-5][0-9]|36[0-6]';break;case 'd':s = p2+'[1-9]|[12]\\d|3[01]';break;case 'w':s = p2+'[1-9]|[1-4][0-9]|5[0-3]';break;case 'E':s = '\\S+';break;case 'h': //hour (1-12)s = p2+'[1-9]|1[0-2]';break;case 'k': //hour (0-11)s = p2+'\\d|1[01]';break;case 'H': //hour (0-23)s = p2+'\\d|1\\d|2[0-3]';break;case 'K': //hour (1-24)s = p2+'[1-9]|1\\d|2[0-4]';break;case 'm':case 's':s = '[0-5]\\d';break;case 'S':s = '\\d{'+l+'}';break;case 'a':var am = options.am || bundle.am || 'AM';var pm = options.pm || bundle.pm || 'PM';if(options.strict){s = am + '|' + pm;}else{s = am + '|' + pm;if(am != am.toLowerCase()){ s += '|' + am.toLowerCase(); }if(pm != pm.toLowerCase()){ s += '|' + pm.toLowerCase(); }}break;default:// case 'v':// case 'z':// case 'Z':s = ".*";// console.debug("parse of date format, pattern=" + pattern);}if(tokens){ tokens.push(match); }return "(" + s + ")"; // add capture}).replace(/[\xa0 ]/g, "[\\s\\xa0]"); // normalize whitespace. Need explicit handling of \xa0 for IE.}})();(function(){var _customFormats = [];dojo.date.locale.addCustomFormats = function(/*String*/packageName, /*String*/bundleName){// summary:// Add a reference to a bundle containing localized custom formats to be// used by date/time formatting and parsing routines.//// description:// The user may add custom localized formats where the bundle has properties following the// same naming convention used by dojo for the CLDR data: dateFormat-xxxx / timeFormat-xxxx// The pattern string should match the format used by the CLDR.// See dojo.date.format for details.// The resources must be loaded by dojo.requireLocalization() prior to use_customFormats.push({pkg:packageName,name:bundleName});};dojo.date.locale._getGregorianBundle = function(/*String*/locale){var gregorian = {};dojo.forEach(_customFormats, function(desc){var bundle = dojo.i18n.getLocalization(desc.pkg, desc.name, locale);gregorian = dojo.mixin(gregorian, bundle);}, this);return gregorian; /*Object*/};})();dojo.date.locale.addCustomFormats("dojo.cldr","gregorian");dojo.date.locale.getNames = function(/*String*/item, /*String*/type, /*String?*/use, /*String?*/locale){// summary:// Used to get localized strings from dojo.cldr for day or month names.//// item: 'months' || 'days'// type: 'wide' || 'narrow' || 'abbr' (e.g. "Monday", "Mon", or "M" respectively, in English)// use: 'standAlone' || 'format' (default)// locale: override locale used to find the namesvar label;var lookup = dojo.date.locale._getGregorianBundle(locale);var props = [item, use, type];if(use == 'standAlone'){label = lookup[props.join('-')];}props[1] = 'format';// return by copy so changes won't be made accidentally to the in-memory modelreturn (label || lookup[props.join('-')]).concat(); /*Array*/};dojo.date.locale.isWeekend = function(/*Date?*/dateObject, /*String?*/locale){// summary:// Determines if the date falls on a weekend, according to local custom.var weekend = dojo.cldr.supplemental.getWeekend(locale);var day = (dateObject || new Date()).getDay();if(weekend.end < weekend.start){weekend.end += 7;if(day < weekend.start){ day += 7; }}return day >= weekend.start && day <= weekend.end; // Boolean};// These are used only by format and strftime. Do they need to be public? Which module should they go in?dojo.date.locale._getDayOfYear = function(/*Date*/dateObject){// summary: gets the day of the year as represented by dateObjectreturn dojo.date.difference(new Date(dateObject.getFullYear(), 0, 1), dateObject) + 1; // Number};dojo.date.locale._getWeekOfYear = function(/*Date*/dateObject, /*Number*/firstDayOfWeek){if(arguments.length == 1){ firstDayOfWeek = 0; } // Sundayvar firstDayOfYear = new Date(dateObject.getFullYear(), 0, 1).getDay();var adj = (firstDayOfYear - firstDayOfWeek + 7) % 7;var week = Math.floor((dojo.date.locale._getDayOfYear(dateObject) + adj - 1) / 7);// if year starts on the specified day, start counting weeks at 1if(firstDayOfYear == firstDayOfWeek){ week++; }return week; // Number};}