JavaScript Date對象

　　本篇主要介紹 Date 日期和時間對象的操做。

目錄

1. 介紹：闡述 Date 對象。

2. 構造函數：介紹 Date 對象的構造函數new Date()幾種方式。

3. 實例方法：介紹 Date 對象的get、set等實例方法。

4. 靜態方法：介紹 Date 對象的靜態方法：Date.now()、 Date.parse()等。

5. 實際操做：介紹 Date 對象的一些示例：獲取倒計時、比較2個Date對象的大小等等。

 

1. 介紹

1.1 說明

Date對象，是操做日期和時間的對象。Date對象對日期和時間的操做只能經過方法。

1.2 屬性

無；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位數字。如：199九、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對象的實例方法主要分爲2種形式：本地時間和UTC時間。同一個方法，通常都會有此2種時間格式操做(方法名帶UTC的，就是操做UTC時間)，這裏主要介紹對本地時間的操做。

 

3.1 get方法

3.1.1 getFullYear() ：返回Date對象的年份值；4位年份。

3.1.2 getMonth() ：返回Date對象的月份值。從0開始，因此真實月份=返回值+1 。

3.1.3 getDate() ：返回Date對象的月份中的日期值；值的範圍1~31 。

3.1.4 getHours() ：返回Date對象的小時值。

3.1.5 getMinutes() ：返回Date對象的分鐘值。

3.1.6 getSeconds() ：返回Date對象的秒數值。

3.1.7 getMilliseconds() ：返回Date對象的毫秒值。

3.1.8 getDay() ：返回Date對象的一週中的星期值；0爲星期天，1爲星期1、2爲星期二，依此類推

3.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') 

 

3.2 set方法

3.2.1 setFullYear(year, opt_month, opt_date) ：設置Date對象的年份值；4位年份。

3.2.2 setMonth(month, opt_date) ：設置Date對象的月份值。0表示1月，11表示12月。

3.2.3 setDate(date) ：設置Date對象的月份中的日期值；值的範圍1~31 。

3.2.4 setHours(hour, opt_min, opt_sec, opt_msec) ：設置Date對象的小時值。

3.2.5 setMinutes(min, opt_sec, opt_msec) ：設置Date對象的分鐘值。

3.2.6 setSeconds(sec, opt_msec) ：設置Date對象的秒數值。

3.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毫秒

 

3.3 其餘方法

3.3.1 toString() ：將Date轉換爲一個'年月日 時分秒'字符串

3.3.2 toLocaleString() ：將Date轉換爲一個'年月日 時分秒'的本地格式字符串

3.3.3 toDateString() ：將Date轉換爲一個'年月日'字符串

3.3.4 toLocaleDateString() ：將Date轉換爲一個'年月日'的本地格式字符串

3.3.5 toTimeString() ：將Date轉換爲一個'時分秒'字符串

3.3.6 toLocaleTimeString() ：將Date轉換爲一個'時分秒'的本地格式字符串

3.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') 

 

4. 靜態方法

4.1 Date.now()

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

參數：無

返回值：

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

示例：

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

  

4.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！)

 

5. 實際操做

5.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 

 

5.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分

 

5.3 比較2個Date對象的大小

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

示例：

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

 

End

Web開發之路系列文章

菜單加載中...