DIV CSS 佈局教程網

JavaScript Date 物件完全解析
編輯:關於JavaScript     

日期與時間的操作幾乎每個專案都躲不掉,而 Date 就是 JavaScript 的 answer。本文系統性地整理它的建構方式、實例方法、靜態方法,並補上幾個實務上常用的操作範例。

目錄

  1. 介紹:Date 物件的定位與特性
  2. 建構函式:new Date() 的四種形式
  3. 實例方法:get / set 系列與格式化轉換
  4. 靜態方法:Date.now()、Date.parse()
  5. 實務操作:倒計時、比較大小、C# DateTime 對接

一、介紹

Date 是操作日期與時間的物件,值得注意的是它沒有公開屬性,所有操作都必須透過方法進行。

二、建構函式

2.1 new Date():取得當前時間

不傳參數,回傳一個表示本地日期與時間的 Date 物件。

var dt = new Date();
console.log(dt);   // => 當前本地日期與時間

2.2 new Date(milliseconds):毫秒數轉 Date

參數是從 1970/01/01 00:00:00 起算的毫秒數,可正可負。
注意:起點還要加上本地時區,東八區的實際起點是 1970/01/01 08:00:00。

var dt = new Date(1000 * 60 * 1);     // 前進 1 分鐘
console.log(dt);                      // => 1970/01/01 08:01:00

dt = new Date(-1000 * 60 * 1);        // 倒退 1 分鐘
console.log(dt);                      // => 1970/01/01 07:59:00

2.3 new Date(dateStr):字串轉 Date

可省略時間部分。字串格式主要有兩種:

  • yyyy/MM/dd HH:mm:ss(推薦):省略時間時,結果為 00:00:00。
  • yyyy-MM-dd HH:mm:ss:省略時間時,結果為 08:00:00(補上本地時區);若不省略時間,此寫法在 IE 會轉換失敗。
var dt = new Date('2014/12/25');
console.log(dt);   // => 2014/12/25 00:00:00

dt = new Date('2014/12/25 12:00:00');
console.log(dt);   // => 2014/12/25 12:00:00

dt = new Date('2014-12-25');
console.log(dt);   // => 2014-12-25 08:00:00(加上了東八區時區)

dt = new Date('2014-12-25 12:00:00');
console.log(dt);   // => 此轉換方式在 IE 中會報錯!

2.4 new Date(year, month, day, hours, minutes, seconds, ms)

以前兩個參數為必填,其餘可選:

  • year:4 位數年份,如 1999、2014
  • month:從 0 起算,0 是 1 月、11 是 12 月
  • day:從 1 起算,取值 1~31
  • hours:0~23;minutes/seconds:0~59;ms:0~999
var dt = new Date(2014, 11);                    // 2014 年 12 月
console.log(dt);   // => 2014/12/01 00:00:00

dt = new Date(2014, 11, 25);                    // 2014 年 12 月 25 日
console.log(dt);   // => 2014/12/25 00:00:00

dt = new Date(2014, 11, 25, 15, 30, 40);
console.log(dt);   // => 2014/12/25 15:30:40

dt = new Date(2014, 12, 25);                    // 月份填 12,等於第 13 個月,自動跨到隔年
console.log(dt);   // => 2015/01/25

最後一個例子說明了 Date 的一個特性:超出範圍的數值會自動進位,這既是陷阱也是工具。

三、實例方法

實例方法大致分兩組:本地時間與 UTC 時間。同名的方法若加上 UTC 前綴就是操作 UTC 時間,以下聚焦在本地時間。

3.1 get 系列

dt.getFullYear();     // => 2014:年(4 位數)
dt.getMonth();        // => 11:月(從 0 起算,實際是 12 月)
dt.getDate();         // => 25:日(1~31)
dt.getHours();        // => 15:時
dt.getMinutes();      // => 30:分
dt.getSeconds();      // => 40:秒
dt.getMilliseconds(); // => 333:毫秒
dt.getDay();          // => 4:星期(0 是週日,1 是週一,依此類推)
dt.getTime();         // => 1419492640333:與 1970/01/01 00:00:00 相差的毫秒數

3.2 set 系列

var dt = new Date();
dt.setFullYear(2014);     // 年
dt.setMonth(11);          // 月(0 起算,這裡是 12 月)
dt.setDate(25);           // 日
dt.setHours(15);          // 時
dt.setMinutes(30);        // 分
dt.setSeconds(40);        // 秒
dt.setMilliseconds(333);  // 毫秒
console.log(dt);          // => 2014 年 12 月 25 日 15 點 30 分 40 秒 333 毫秒

3.3 格式化轉換

var dt = new Date();

dt.toString();            // => Tue Dec 23 2014 22:56:11 GMT+0800(中國標準時間)
dt.toLocaleString();      // => 2014年12月23日 下午10:56:11
dt.toDateString();        // => Tue Dec 23 2014
dt.toLocaleDateString();  // => 2014年12月23日
dt.toTimeString();        // => 22:56:11 GMT+0800(中國標準時間)
dt.toLocaleTimeString();  // => 下午10:56:11
dt.valueOf();             // => 同 getTime(),回傳毫秒數

四、靜態方法

4.1 Date.now()

回傳目前時間與起始時間之間的毫秒數,不接受參數。

console.log(Date.now());   // => 1419431519276

4.2 Date.parse(dateStr)

把字串轉為 Date 之後,回傳它與起始時間之間的毫秒數。格式規則與 new Date(str) 相同:yyyy/MM/dd HH:mm:ss 較保險;yyyy-MM-dd HH:mm:ss 在 IE 會回傳 NaN。

console.log(Date.parse('2014/12/25 12:00:00'));   // => 1419480000000
console.log(Date.parse('2014-12-25 12:00:00'));   // => 1419480000000(IE 中會回傳 NaN!)

五、實務操作

5.1 把 C# 的 DateTime 轉為 JS 的 Date

C# 的 DateTime 經由 JSON 序列化後,格式長得像 "\/Date(1419492640000)\/",括號中的數字就是與起始時間相差的毫秒數。

後端(簡單的 ashx):

public void ProcessRequest (HttpContext context) {
    System.Web.Script.Serialization.JavaScriptSerializer js =
        new System.Web.Script.Serialization.JavaScriptSerializer();
    DateTime dt = DateTime.Parse("2014-12-25 15:30:40");
    string rs = js.Serialize(dt);          // 序列化成 JSON
    context.Response.ContentType = "text/plain";
    context.Response.Write(rs);
}

前端:

var dateTimeJsonStr = '\/Date(1419492640000)\/';   // C# DateTime 轉換後的 JSON 格式

// 用正則把毫秒數字抽出來
var msecStr = dateTimeJsonStr.toString().replace(/\/Date\(([-]?\d+)\)\//gi, "$1");   // => '1419492640000'
var msesInt = Number.parseInt(msecStr);                                            // 轉成數值
var dt = new Date(msesInt);                                                        // 初始化 Date

console.log(dt.toLocaleString());   // => 2014年12月25日 下午3:30:40

5.2 計算倒計時

/**
 * 回傳剩餘時間
 * @param dt {Date} 目標時間
 * @return {String} 形如「X天X時X分」
 */
function getDownTime(dt) {
    var intervalMsec = dt - Date.now();          // 目標時間減現在時間,得到毫秒差
    var intervalSec = intervalMsec / 1000;

    var day  = parseInt(intervalSec / 3600 / 24);
    var hour = parseInt((intervalSec - day * 24 * 3600) / 3600);
    var min  = parseInt((intervalSec - day * 24 * 3600 - hour * 3600) / 60);

    // 若目標時間已過去,毫秒差為負,此時把時、分也轉負
    if (intervalMsec < 0) {
        hour = 0 - hour;
        min = 0 - min;
    }

    return day + '天' + hour + '時' + min + '分';
}

// 假設現在是 2014/12/28 13:26
console.log(getDownTime(new Date('2015/06/01')));   // => 154天10時33分
console.log(getDownTime(new Date('2014/01/01')));   // => -361天13時26分

5.3 比較兩個 Date 的大小

由於 Date 物件在比較時會轉成毫秒數,可以直接用 >/< 運算子:

var dt1 = new Date('2015/12/01');
var dt2 = new Date('2015/12/25');
console.log(dt1 > dt2);   // => false

以上就是本文的全部內容,希望對大家的學習有所幫助。

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