插件 jQuery.dateFormat 中文API文档

插件 jQuery.dateFormat 中文API文档 https://github.com/phstc/jquery-dateFormat

使用JavaScript格式化Date输出的jQuery插件

格式模式

格式化模式基于java.text.SimpleDateFormat。

日期和时间模式

• yy =短年
• yyyy =漫长的一年
• M =月（1-12）
• MM =月（01-12）
• MMM =月份缩写（Jan，Feb … Dec）
• MMMM =长月（1月，2月…… 12月）
• d =天（1 - 31）
• dd =天（01 - 31）
• ddd =一周中的星期几（周一，周二……周日）
• E =一周中的短日子（周一，周二……周日）
• D - 序数日（第1，第2，第3，第21，第22，第23，第31，第4 ……）
• h =上午/下午小时（0-12）
• hh =上午/下午（00-12）
• H =一天中的小时（0-23）
• HH =一天中的小时（00-23）
• mm =分钟
• ss =秒
• SSS =毫秒
• a = AM / PM标记
• p = am / pm标记

预期的输入日期格式

• 1982-10-15T01：10：20 + 02：00
• 1982-10-15T01：10：20Z
• Thu Oct 15 01:10:20 CET 1982
• 1982-10-15 01：10：20.546
• Thu Oct 15 1982 01:10:20 GMT-0800（太平洋标准时间）
• Thu Oct 15 1982 01:10:20 GMT + 0800（中国标准时间）
• Thu Oct 15 1982 01:10:20 GMT + 0200（W. Europe Daylight Time）
• 1982-10-15CET01：10：20
• JavaScript：new Date（）。getTime（）

用法

 <script>
   document.write($.format.date("2009-12-18 10:54:50.546", "Test: dd/MM/yyyy"));
   document.write($.format.date("Wed Jan 13 10:43:41 CET 2010", "dd~MM~yyyy"));
 </script>

out

 => Test: 18/12/2009
 => 13~01~2010

使用css类格式化

  <span class="shortDateFormat">2009-12-18 10:54:50.546</span>
  <span class="longDateFormat">2009-12-18 10:54:50.546</span>
  jQuery(function() {
      var shortDateFormat = 'dd/MM/yyyy';
      var longDateFormat  = 'dd/MM/yyyy HH:mm:ss';

      jQuery(".shortDateFormat").each(function (idx, elem) {
          if (jQuery(elem).is(":input")) {
              jQuery(elem).val(jQuery.format.date(jQuery(elem).val(), shortDateFormat));
          } else {
              jQuery(elem).text(jQuery.format.date(jQuery(elem).text(), shortDateFormat));
          }
      });
      jQuery(".longDateFormat").each(function (idx, elem) {
          if (jQuery(elem).is(":input")) {
              jQuery(elem).val(jQuery.format.date(jQuery(elem).val(), longDateFormat));
          } else {
              jQuery(elem).text(jQuery.format.date(jQuery(elem).text(), longDateFormat));
          }
      });
  });

输出

 => 18/12/2009
 => 18/12/2009 10:54:50

漂亮的日期格式

jQuery.format.prettyDate(value) 返回表示日期所代表的时间的字符串

value =表示ISO时间或日期的字符串，以毫秒为单位或javascript日期对象

 jQuery.format.prettyDate(new Date())             // => "just now"
 jQuery.format.prettyDate(new Date().getTime())   // => "just now"
 jQuery.format.prettyDate("2008-01-28T20:24:17Z") // => "2 hours ago"
 jQuery.format.prettyDate("2008-01-27T22:24:17Z") // => "Yesterday"
 jQuery.format.prettyDate("2008-01-26T22:24:17Z") // => "2 days ago"
 jQuery.format.prettyDate("2008-01-14T22:24:17Z") // => "2 weeks ago"
 jQuery.format.prettyDate("2007-12-15T22:24:17Z") // => "more than 5 weeks ago"

toBrowserTimeZone

jQuery.format.toBrowserTimeZone(value, format) 转换为浏览器时区。

• value =表示ISO时间中的日期的字符串（“2013-09-14T23：22：33Z”）或表示java.util.Date（“2013-09-14T16：22：33.527-07：00”）的默认JAXB格式的字符串或表示Unix时间戳的字符串（星期六2013年9月14日16:22:33 GMT-0700（PDT））或javascript日期对象。
• format =所有有效的输入格式jQuery.format.date对此方法有效。defaut格式为MM / dd / yyyy HH：mm：ss。

有效的输入格式

 var date1 = "2013-09-14T23:22:33Z";
 var date2 = "2013-09-14T16:22:33.527-07:00";
 var date3 = "Sat Sep 14 2013 16:22:33 GMT-0700 (PDT)";

 $.format.toBrowserTimeZone(date1)
 $.format.toBrowserTimeZone(date2)
 $.format.toBrowserTimeZone(date3)