DIV CSS 佈局教程網

JavaScript 日期格式化筆記:Date 方法與自訂 format
編輯:JavaScript基礎知識     

廢話不多說,先把 Date 物件最常用的取值方法列出來。

Date 的取用方法

var myDate = new Date();

myDate.getYear();           // 取得當前年份(2 位)
myDate.getFullYear();       // 取得完整年份(4 位,1970-????)
myDate.getMonth();          // 取得當前月份(0-11,0 代表 1 月)
myDate.getDate();           // 取得當前日(1-31)
myDate.getDay();            // 取得當前星期(0-6,0 代表星期日)
myDate.getTime();           // 取得時間戳(從 1970.1.1 起的毫秒數)
myDate.getHours();          // 取得小時(0-23)
myDate.getMinutes();        // 取得分鐘(0-59)
myDate.getSeconds();        // 取得秒數(0-59)
myDate.getMilliseconds();   // 取得毫秒(0-999)
myDate.toLocaleDateString();// 取得當前日期
var mytime = myDate.toLocaleTimeString(); // 取得當前時間
myDate.toLocaleString();    // 取得日期與時間

最容易搞混的是這三個:getMonth() 從 0 開始算、getDate() 是月份中的第幾天、getDay() 是星期幾。名字相近、意義完全不同,是無數 off-by-one bug 的來源。

自訂 format 方法

Date 可以說是 Web 專案中不可或缺的類別。下面這個擴充方法能讓你用熟悉的 pattern 字串輸出日期:

Date.prototype.format = function(format)
{
  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;
}

使用方式(必須先宣告再使用):

var d = new Date().format('yyyy-MM-dd');

它的運作原理值得拆解一下:正則 /(y+)/ 抓到連續的 y,再用 substr 從四位年份中裁出對應長度,因此 yy 會得到後兩位、yyyy 得到完整四位;而 ("00" + o[k]).substr(("" + o[k]).length) 這段則是靠字串補零來達成「一位數補成兩位」的效果。技巧聰明,但也說明了一件事:日期格式化在 JavaScript 中長年是個需要自己動手的麻煩事。

另一條路:內建方法與格式化類

JavaScript 的日期物件是 Date,那要如何把日期物件按自訂格式輸出?Date 內建了四個輸出字串的方法:

  1. toGMTString:按 GMT 格式顯示日期。
  2. toLocaleString:按本機作業系統格式顯示。
  3. toLocaleDateString:按本機格式顯示日期部分。
  4. toLocaleTimeString:按本機格式顯示時間部分。

問題是這些格式由系統決定,你無法控制。若要自訂,JsJava 提供了專用的類:引入 src/jsjava/text/DateFormat.js(或直接引入 jslib/jsjava-2.0.js),寫法如下:

var df = new SimpleDateFormat();// jsJava 1.0 需使用 DateFormat 物件,不要弄錯
df.applyPattern("yyyy-MM-dd HH:mm:ss");
var date = new Date(2007,3,30,10,59,51);
var str = df.format(date);
document.write(str);// 顯示結果為:2007-04-30 10:59:51

你只要指定 pattern,剩下的交給它。pattern 中那些字母都是佔位符,各自代表不同含義(例如 y 表示年、yyyy 表示四位數年份)。以下列出支援的特殊字元:

G   Era designator        Text        AD
y   Year                  Year        1996; 96
M   Month in year         Month       July; Jul; 07
w   Week in year          Number      27
W   Week in month         Number      2
D   Day in year           Number      189
d   Day in month          Number      10
F   Day of week in month  Number      2
E   Day in week           Text        Tuesday; Tue
a   Am/pm marker          Text        PM
H   Hour in day (0-23)    Number      0
k   Hour in day (1-24)    Number      24
K   Hour in am/pm (0-11)  Number      0
h   Hour in am/pm (1-12)  Number      12
m   Minute in hour        Number      30
s   Second in minute      Number      55
S   Millisecond           Number      978

這張表引自 Java 官方文件並做了些許調整。若你學過 Java 的日期格式化,這些佔位符會很熟悉;沒學過也無妨,常用的其實只有 yyyy、MM、dd、HH、mm、ss 這六個。

今天該怎麼做

上面兩種方案都屬於歷史產物。現在處理日期有更好的選擇:

  • Date.prototype.toLocaleDateString() 搭配 Intl.DateTimeFormat,可以直接指定 locale 與各欄位格式,不必自己補零。
  • 新版 toISOString() 與字串切片,是處理 ISO 8601 格式最乾淨的方式。
  • 複雜運算(時區、閏年、跨月差值)建議用 dayjs 或 date-fns 這類輕量庫,Moment.js 已進入維護模式,新專案不建議再採用。

另外,直接擴充 Date.prototype 這種做法在現代開發中並不鼓勵:它會污染全域原型,一旦與其他庫的實作衝突就很難排查。改成獨立函數 formatDate(date, pattern),收益遠大於成本。

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