DIV CSS 佈局教程網

JavaScript 自訂日期格式化函式詳解
編輯:JavaScript綜合知識     

Date 物件只提供了 getDate()、getMinutes() 等取得單一元素的方法,並沒有直接轉為特定字串格式的功能,因此實務上往往需要自行封裝格式化函式。本文從原理到實作完整解析這項技巧。

兩種擴充思路

常見做法有兩種:一是擴充 Date.prototype,讓格式化方法猶如原生方法般呼叫;二是撰寫獨立的函式。擴充原型雖方便,卻有「入侵」原型的疑慮,設計 API 時值得斟酌。

核心原理

傳統的字串拼接雖能實現,但效率與可讀性都不理想,引入正規表達式才是恰當之舉。以下先欣賞來自 Steven Levithan 的完整版本:

dateFormat = (function(){
  var token
    = /d{1,4}|m{1,4}|yy(?:yy)?|([HhMsTt])\1?|[LloSZ]|"[^"]*"|'[^']*'/g,
    timezone
    = /\b(?:[PMCEA][SDP]T|(?:Pacific|Mountain|Central|Eastern|Atlantic) (?:Standard|Daylight|Prevailing) Time|(?:GMT|UTC)(?:[-+]\d{4})?)\b/g,
    timezoneClip = /[^-+\dA-Z]/g,
    pad
    = function (val, len){
      val = String(val);
      len = len || 2;
      while (val.length < len) val = "0" + val;
      return val;
    };
  // Regexes and supporting functions are cached through closure
  return function (date, mask, utc) {
    var i18n = dateFormat.i18n;
    var masks = dateFormat.masks;
    if (arguments.length == 1 && Object.prototype.toString.call(date) == "[object String]" && !/\d/.test(date)) {
      mask = date;
      date = undefined;
    }
    date = date ? new Date(date) : new Date;
    if (isNaN(date)) throw SyntaxError("invalid date");
    mask = String(masks[mask] || mask || masks["default"]);
    if (mask.slice(0, 4) == "UTC:") {
      mask = mask.slice(4);
      utc = true;
    }
    var _ = utc ? "getUTC" : "get",
        d = date[_ + "Date"](),
        D = date[_ + "Day"](),
        m = date[_ + "Month"](),
        y = date[_ + "FullYear"](),
        H = date[_ + "Hours"](),
        M = date[_ + "Minutes"](),
        s = date[_ + "Seconds"](),
        L = date[_ + "Milliseconds"](),
        o = utc ? 0 : date.getTimezoneOffset(),
        flags = {
          d:    d,
          dd:   pad(d),
          ddd:  i18n.dayNames[D],
          dddd: i18n.dayNames[D + 7],
          m:    m + 1,
          mm:   pad(m + 1),
          mmm:  i18n.monthNames[m],
          mmmm: i18n.monthNames[m + 12],
          yy:   String(y).slice(2),
          yyyy: y,
          h:    H % 12 || 12,
          hh:   pad(H % 12 || 12),
          H:    H,
          HH:   pad(H),
          M:    M,
          MM:   pad(M),
          s:    s,
          ss:   pad(s),
          l:    pad(L, 3),
          L:    pad(L > 99 ? Math.round(L / 10) : L),
          t:    H < 12 ? "a"  : "p",
          tt:   H < 12 ? "am" : "pm",
          T:    H < 12 ? "A"  : "P",
          TT:   H < 12 ? "AM" : "PM",
          Z:    utc ? "UTC" : (String(date).match(timezone) || [""]).pop().replace(timezoneClip, ""),
          o:    (o > 0 ? "-" : "+") + pad(Math.floor(Math.abs(o) / 60) * 100 + Math.abs(o) % 60, 4),
          S:    ["th", "st", "nd", "rd"][d % 10 > 3 ? 0 : (d % 100 - d % 10 != 10) * d % 10]
        };
    return mask.replace(token, function ($0) {
      return $0 in flags ? flags[$0] : $0.slice(1, $0.length - 1);
    });
  };
})();

這份程式先在 mask 中約定 yyyy、mm、dd 等有意義的符號代表日期元素,再逐一取出各元素,最後以 mask.replace(正則, 元素) 完成替換,並以 flags 對照表比對。

預先定義常用格式

每次輸入冗長的 mask 字串未免麻煩,可透過常數預先定義:

dateFormat.masks = {
  "default":   "ddd mmm dd yyyy HH:MM:ss",
  shortDate:   "m/d/yy",
  mediumDate:  "mmm d, yyyy",
  longDate:    "mmmm d, yyyy",
  fullDate:    "dddd, mmmm d, yyyy",
  shortTime:   "h:MM TT",
  mediumTime:  "h:MM:ss TT",
  longTime:    "h:MM:ss TT Z",
  isoDate:     "yyyy-mm-dd",
  isoTime:     "HH:MM:ss",
  isoDateTime: "yyyy-mm-dd'T'HH:MM:ss",
  isoUtcDateTime: "UTC:yyyy-mm-dd'T'HH:MM:ss'Z'",
  ChineseDate : 'yyyy年mm月dd日 HH時MM分'
};
dateFormat.i18n = {
  dayNames: [
    "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat",
    "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"
  ],
  monthNames: [
    "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
    "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"
  ]
};

更精煉的版本

相較之下,月影前輩的寫法不到 20 行,卻將正則運用得淋漓盡致:

Date.prototype.format = function(format) //author: meizz
{
  var o = {
    "M+" : this.getMonth()+1, //month
    "d+" : this.getDate(),    //day
    "h+" : this.getHours(),   //hour
    "m+" : this.getMinutes(), //minute
    "s+" : this.getSeconds(), //second
    "q+" : Math.floor((this.getMonth()+3)/3), //quarter
    "S" : this.getMilliseconds() //millisecond
  }
  if(/(y+)/.test(format)) format=format.replace(RegExp.$1,
    (this.getFullYear()+"").substr(4 - RegExp.$1.length));
  for(var k in o)if(new RegExp("("+ k +")").test(format))
    format = format.replace(RegExp.$1,
      RegExp.$1.length==1 ? o[k] :
      ("00"+ o[k]).substr((""+ o[k]).length));
  return format;
}
alert(new Date().format("yyyy-MM-dd hh:mm:ss"));

其中 ("00" + o[k]).substr(("" + o[k]).length) 是巧妙之處:透過在前面補上「00」再截取,即可取得最後兩位,實現補零效果。此外 test() 不僅用於檢測,還會產生 RegExp.$1 結果組供後續處理。

若覺得原版不易閱讀,也可改寫為語意清晰的版本,原理一致但少了技巧性:

date = {
  format: function(date, format){
    date = new Date(date);
    date = {
      year : date.getFullYear()
      ,month : date.getMonth() + 1
      ,day : date.getDate()
      ,hour : date.getHours()
      ,minute : date.getMinutes()
      ,second : date.getSeconds()
      ,milute : date.getMilliseconds()
    };
    var match ,reg = /(y+)|(Y+)|(M+)|d+|h+|m+|s+|u+/g;
    while((match = reg.exec(format)) != null){
      match = match[0];
      if(/y/i.test(match)){ format = format.replace(match, date.year); }
      if(match.indexOf('M') != -1){ format = format.replace(match, date.month); }
      if(match.indexOf('d') != -1){ format = format.replace(match, date.day); }
      if(match.indexOf('h') != -1){ format = format.replace(match, date.hour); }
      if(match.indexOf('m') != -1){ format = format.replace(match, date.minute); }
      if(match.indexOf('s') != -1){ format = format.replace(match, date.second); }
      if(match.indexOf('u') != -1){ format = format.replace(match, date.milute); }
    }
    return format;
  }
};

掌握正則與 replace 的搭配後,日期格式化便能收放自如,也能延伸出各式中英文格式輸出。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved