JavaScriptDate物件介紹

傑克.陳發表於2014-12-29
原文: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開發之路系列文章

 


相關文章