JavaScript Date對象

時間 2019-12-07

標籤 javascript date 對象欄目 JavaScript 简体版

原文原文鏈接

本文轉載於：http://www.javashuo.com/article/p-mjirxmih-cb.html

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

1. 介紹

1.1 說明

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

1.2 屬性

無；Date對象對日期和時間的操做只能經過方法。htm

2. 構造函數

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

參數：無對象

返回值：blog

{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