淺談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         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