目錄

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 = newDate(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對象的實例方法主要分為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為星期一、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