DIV CSS 佈局教程網

JavaScript Date 物件速查:建立方式與方法全整理
編輯:JavaScript基礎知識     

Date 物件專門用來處理日期與時間,是前端開發中最常被翻文件的物件之一。這篇把它整理成可以直接查的參照表。

建立 Date 物件

var myDate = new Date();

不帶參數時,會自動以「當下的日期與時間」作為初始值。若要指定時間,共有五種參數形式:

new Date("month dd,yyyy hh:mm:ss");
new Date("month dd,yyyy");
new Date(yyyy, mth, dd, hh, mm, ss);
new Date(yyyy, mth, dd);
new Date(ms);

最後一種要特別注意:參數是「與 GMT 1970 年 1 月 1 日相差的毫秒數」,也就是所謂的時間戳。

參數含義

  • month:英文月份名稱,January 到 December
  • mth:整數月份,0 到 11(0 是 1 月)
  • dd:當月第幾天,1 到 31
  • yyyy:四位數年份
  • hh:小時,0(午夜)到 23
  • mm:分鐘,0 到 59
  • ss:秒,0 到 59
  • ms:毫秒,大於等於 0 的整數

實際範例:

new Date("January 12,2006 22:19:35");
new Date("January 12,2006");
new Date(2006, 0, 12, 22, 19, 35);
new Date(2006, 0, 12);
new Date(1137075575000);

月份從 0 開始計算這點最容易出錯,new Date(2006, 0, 12) 是 1 月 12 日而非 12 月 1 日。另外字串形式的解析結果在各瀏覽器上未必一致,正式專案建議一律用數值參數或 ISO 8601 字串(如 "2006-01-12T22:19:35")。

取值方法(getter)

  • Date():回傳當日日期與時間字串
  • getDate():當月日期(1–31)
  • getDay():當週第幾天(0–6,0 是星期日)
  • getMonth():月份(0–11)
  • getFullYear():四位數年份(取代已不建議的 getYear())
  • getHours() / getMinutes() / getSeconds() / getMilliseconds():時、分、秒、毫秒
  • getTime():1970-01-01 至今的毫秒數
  • getTimezoneOffset():本地時間與 GMT 的分鐘差
  • getUTCDate() 等 UTC 系列:以世界時為基準回傳日、週、月、年、時、分、秒、毫秒
  • parse():把日期字串解析為 1970-01-01 午夜起的毫秒數

設值方法(setter)

setDate()、setMonth()、setFullYear()、setHours()、setMinutes()、setSeconds()、setMilliseconds() 分別設定各個欄位;setTime() 以毫秒直接設定整個時間值。對應的 UTC 版本為 setUTCDate() 到 setUTCMilliseconds()。同樣地,setYear() 已建議改用 setFullYear()。

轉換與輸出

  • toSource():回傳物件原始碼(非標準)
  • toString():轉為完整字串
  • toDateString() / toTimeString():只取日期或時間部分
  • toUTCString():以世界時輸出(取代 toGMTString())
  • toLocaleString() / toLocaleDateString() / toLocaleTimeString():依本地格式輸出
  • toISOString():輸出標準 ISO 8601 字串,跨系統交換資料時最可靠
  • UTC():以世界時計算指定日期距 1997-01-01 的毫秒數
  • valueOf():回傳物件的原始數值,也就是時間戳

實務上最實用的兩個補充:toISOString() 拿來存進 API 或資料庫,valueOf() 或直接 +date 拿來做時間差運算。日期格式化若不想自己拼字串,toLocaleDateString('zh-TW') 或 Intl.DateTimeFormat 都能省下不少工夫。

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