JavaScriptDate物件介紹

傑克.陳發表於2014-12-29
JavaScript物件
原文:JavaScript Date物件介紹

Date 日期和時間物件

1. 介紹

　　Date物件，是操作日期和時間的物件。Date物件對日期和時間的操作只能通過方法。

2. 建構函式

2.1 new Date() ：返回當前的本地日期和時間

引數：無

返回值：

{Date} 返回一個表示本地日期和時間的Date物件。

示例：

var dt = new Date();
console.log(dt); // => 返回一個表示本地日期和時間的Date物件

 

2.2 new Date(milliseconds) ：把毫秒數轉換為Date物件

引數：

①milliseconds {int} ：毫秒數；表示從`1970/01/01 00:00:00`為起點，開始疊加的毫秒數。

注意：起點的時分秒還要加上當前所在的時區，北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`

返回值：

{Date} 返回一個疊加後的Date物件。

示例：

var dt = new Date(1000 * 60 * 1); // 前進1分鐘的毫秒數
console.log(dt); // => {Date}:1970/01/01 08:01:00
dt = new Date(-1000 * 60 * 1); // 倒退1分鐘的毫秒數
console.log(dt); // => {Date}:1970/01/01 07:59:00

 

2.3 new Date(dateStr) ：把字串轉換為Date物件

引數：

①dateStr {string} ：可轉換為Date物件的字串(可省略時間)；字串的格式主要有兩種：

1) yyyy/MM/dd HH:mm:ss （推薦）：若省略時間，返回的Date物件的時間為 00:00:00。

2) yyyy-MM-dd HH:mm:ss ：若省略時間，返回的Date物件的時間為 08:00:00(加上本地時區)。若不省略時間，此字串在IE中會轉換失敗!

返回值：

{Date} 返回一個轉換後的Date物件。

示例：

var dt = new Date(`2014/12/25`); // yyyy/MM/dd
console.log(dt); // => {Date}:2014/12/25 00:00:00
dt = new Date(`2014/12/25 12:00:00`); // yyyy/MM/dd HH:mm:ss
console.log(dt); // => {Date}:2014/12/25 12:00:00

dt = new Date(`2014-12-25`); // yyyy-MM-dd
console.log(dt); // => {Date}:2014-12-25 08:00:00 (加上了東8區的時區)
dt = new Date(`2014-12-25 12:00:00`); // yyyy-MM-dd HH:mm:ss (注意：此轉換方式在IE中會報錯！)
console.log(dt); // => {Date}:2014-12-25 12:00:00

 

2.4 new Date(year, month, opt_day, opt_hours, opt_minutes, opt_seconds, opt_milliseconds) ：把年月日、時分秒轉換為Date物件

引數：

①year {int} ：年份；4位數字。如：1999、2014

②month {int} ：月份；2位數字。從0開始計算，0表示1月份、11表示12月份。

③opt_day {int} 可選：號； 2位數字；從1開始計算，1表示1號。

④opt_hours {int} 可選：時；2位數字；取值0~23。

⑤opt_minutes {int} 可選：分；2位數字；取值0~59。

⑥opt_seconds {int} 可選：秒；2未數字；取值0~59。

⑦opt_milliseconds {int} 可選：毫秒；取值0~999。

返回值：

{Date} 返回一個轉換後的Date物件。

示例：

var dt = new Date(2014, 11); // 2014年12月(這裡輸入的月份數字為11) 
console.log(dt); // => {Date}:2014/12/01 00:00:00
dt = new Date(2014, 11, 25); // 2014年12月25日
console.log(dt); // => {Date}:2014/12/25 00:00:00
dt = new Date(2014, 11, 25, 15, 30, 40); // 2014年12月25日 15點30分40秒
console.log(dt); // => {Date}:2014/12/25 15:30:40
dt = new Date(2014, 12, 25); // 2014年13月25日(這裡輸入的月份數字為12，表示第13個月，跳轉到第二年的1月)
console.log(dt); // => {Date}:2015/01/25

 

3. 屬性

無；Date物件對日期和時間的操作只能通過方法。

 

4. 例項方法

　　Date物件的例項方法主要分為2種形式：本地時間和UTC時間。同一個方法，一般都會有此2種時間格式操作(方法名帶UTC的，就是操作UTC時間)，這裡主要介紹對本地時間的操作。

 

4.1 get方法

4.1.1 getFullYear() ：返回Date物件的年份值；4位年份。

4.1.2 getMonth() ：返回Date物件的月份值。從0開始，所以真實月份=返回值+1 。

4.1.3 getDate() ：返回Date物件的月份中的日期值；值的範圍1~31 。

4.1.4 getHours() ：返回Date物件的小時值。

4.1.5 getMinutes() ：返回Date物件的分鐘值。

4.1.6 getSeconds() ：返回Date物件的秒數值。

4.1.7 getMilliseconds() ：返回Date物件的毫秒值。

4.1.8 getDay() ：返回Date物件的一週中的星期值；0為星期天，1為星期一、2為星期二，依此類推

4.1.9 getTime() ：返回Date物件與`1970/01/01 00:00:00`之間的毫秒值(北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`) 。

示例：

dt.getFullYear(); // => 2014：年
dt.getMonth(); // => 11：月；實際為12月份(月份從0開始計算)
dt.getDate(); // => 25：日
dt.getHours(); // => 15：時
dt.getMinutes(); // => 30：分
dt.getSeconds(); // => 40：秒
dt.getMilliseconds(); // => 333：毫秒
dt.getDay(); // => 4：星期幾的值
dt.getTime(); // => 1419492640333 ：返回Date物件與`1970/01/01 00:00:00`之間的毫秒值(北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`)

 

4.2 set方法

4.2.1 setFullYear(year, opt_month, opt_date) ：設定Date物件的年份值；4位年份。

4.2.2 setMonth(month, opt_date) ：設定Date物件的月份值。0表示1月，11表示12月。

4.2.3 setDate(date) ：設定Date物件的月份中的日期值；值的範圍1~31 。

4.2.4 setHours(hour, opt_min, opt_sec, opt_msec) ：設定Date物件的小時值。

4.2.5 setMinutes(min, opt_sec, opt_msec) ：設定Date物件的分鐘值。

4.2.6 setSeconds(sec, opt_msec) ：設定Date物件的秒數值。

4.2.7 setMilliseconds(msec) ：設定Date物件的毫秒值。

示例：

var dt = new Date();
dt.setFullYear(2014); // => 2014：年
dt.setMonth(11); // => 11：月；實際為12月份(月份從0開始計算)
dt.setDate(25); // => 25：日
dt.setHours(15); // => 15：時
dt.setMinutes(30); // => 30：分
dt.setSeconds(40); // => 40：秒
dt.setMilliseconds(333); // => 333：毫秒
console.log(dt); // =>  2014年12月25日 15點30分40秒 333毫秒

 

4.3 其他方法

4.3.1 toString() ：將Date轉換為一個`年月日 時分秒`字串

4.3.2 toLocaleString() ：將Date轉換為一個`年月日 時分秒`的本地格式字串

4.3.3 toDateString() ：將Date轉換為一個`年月日`字串

4.3.4 toLocaleDateString() ：將Date轉換為一個`年月日`的本地格式字串

4.3.5 toTimeString() ：將Date轉換為一個`時分秒`字串

4.3.6 toLocaleTimeString() ：將Date轉換為一個`時分秒`的本地格式字串

4.3.7 valueOf() ：與getTime()一樣， 返回Date物件與`1970/01/01 00:00:00`之間的毫秒值(北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`) 

示例：

var dt = new Date();
console.log(dt.toString()); // => Tue Dec 23 2014 22:56:11 GMT+0800 (中國標準時間) ：將Date轉換為一個`年月日 時分秒`字串
console.log(dt.toLocaleString()); // => 2014年12月23日 下午10:56:11  ：將Date轉換為一個`年月日 時分秒`的本地格式字串

console.log(dt.toDateString()); // => Tue Dec 23 2014 ：將Date轉換為一個`年月日`字串
console.log(dt.toLocaleDateString()); // => 2014年12月23日 ：將Date轉換為一個`年月日`的本地格式字串

console.log(dt.toTimeString()); // => 22:56:11 GMT+0800 (中國標準時間) ：將Date轉換為一個`時分秒`字串
console.log(dt.toLocaleTimeString()); // => 下午10:56:11 ：將Date轉換為一個`時分秒`的本地格式字串

console.log(dt.valueOf()); // => 返回Date物件與`1970/01/01 00:00:00`之間的毫秒值(北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`)

 

5. 靜態方法

5.1 Date.now()

說明：返回當前日期和時間的Date物件與`1970/01/01 00:00:00`之間的毫秒值(北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`) 

引數：無

返回值：

{int} ：當前時間與起始時間之間的毫秒數。

示例：

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

  

5.2 Date.parse(dateStr)

說明：把字串轉換為Date物件 ，然後返回此Date物件與`1970/01/01 00:00:00`之間的毫秒值(北京時間的時區為東8區，起點時間實際為：`1970/01/01 08:00:00`)

引數：

①dateStr {string} ：可轉換為Date物件的字串(可省略時間)；字串的格式主要有兩種：

1) yyyy/MM/dd HH:mm:ss （推薦）：若省略時間，返回的Date物件的時間為 00:00:00。

2) yyyy-MM-dd HH:mm:ss ：若省略時間，返回的Date物件的時間為 08:00:00(加上本地時區)。若不省略時間，此字串在IE中返回NaN(非數字)!

返回值：

{int} 返回轉換後的Date物件與起始時間之間的毫秒數。

示例：

console.log(Date.parse(`2014/12/25 12:00:00`)); // => 1419480000000 
console.log(Date.parse(`2014-12-25 12:00:00`)); // => 1419480000000  (注意：此轉換方式在IE中返回NaN！)

 

6. 實際操作

6.1 C#的DateTime型別轉換為Js的Date物件

說明：C#的DateTime型別通過Json序列化返回給前臺的格式為：”/Date(1419492640000)/” 。中間的數字，表示DateTime的值與起始時間之間的毫秒數。

示例：

後臺程式碼：簡單的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

 

6.2  獲取倒數計時

說明：計算當前時間離目的時間相差多少天時分。

示例：

/**
* 返回倒數計時
* @param dt {Date}：目的Date物件
* @return {Strin} ：返回倒數計時：X天X時X分
*/
function getDownTime(dt) {
    // 1.獲取倒數計時
    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); // 分鐘

    // 2.若相差的毫秒小於0 ,表示目的時間小於當前時間，這時的取的值都是負的：-X天-時-分，顯示時，只顯示天數前面為負的就行。
    if (intervalMsec < 0) {
        hour = 0 - hour;
        min = 0 - min;
    }

    // 3.拼接字串並返回
    var rs = day + `天` + hour + `時` + min + `分`;
    return rs;
}

// 當前時間：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分

 

6.3 比較2個Date物件的大小

說明：可以對比2者的與起始時間的毫秒數，來區分大小。

示例：

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

 

==================================系列文章==========================================

本篇文章：3.4  JavaScript Date物件介紹

Web開發之路系列文章

 


相關文章