2014年12月29日 星期一

[轉貼] JavaScript Date對象介紹

出處:http://www.cnblogs.com/polk6/p/4156595.html

Date 日期和時間對象

1. 介紹

  Date對象,是操作日期和時間的對象。Date對象對日期和時間的操作只能通過方法。

2. 構造函數

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

參數:
返回值:
{Date} 返回一個表示本地日期和時間的Date對象。
示例:
1
2
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對象。
示例:
1
2
3
4
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對象。
示例:
1
2
3
4
5
6
7
8
9
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對象。
示例:
1
2
3
4
5
6
7
8
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') 。

示例:
1
2
3
4
5
6
7
8
9
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對象的毫秒值。

示例:

1
2
3
4
5
6
7
8
9
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') 

示例:

1
2
3
4
5
6
7
8
9
10
11
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} :當前時間與起始時間之間的毫秒數。
示例:
1
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對象與起始時間之間的毫秒數。
示例:
1
2
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
1
2
3
4
5
6
7
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);
}
前台代碼:
1
2
3
4
5
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  獲取倒計時

說明:計算當前時間離目的時間相差多少天時分。
示例:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
/**
* 返回倒計時
* @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者的與起始時間的毫秒數,來區分大小。
示例:
1
2
3
var dt1 = new Date('2015/12/01');
var dt2 = new Date('2015/12/25');
console.log(dt1 > dt2); // => false

****************************************************************

//天數加減 addDate("2015/01/01", 7)
function addDate(strDay, dadd) {
    var oldDay = new Date(strDay);
    oldDay = oldDay.valueOf();
    oldDay = oldDay + (dadd * 24 * 60 * 60 * 1000);
    var newDay = new Date(oldDay);
    var years = newDay.getFullYear();
    var months = "00" + (newDay.getMonth() + 1);
    var days = "00" + newDay.getDate();
    newDay = years + "/" + (months).substr(months.length - 2, 2) + "/" + (days).substr(days.length - 2, 2);
    return newDay;
}

沒有留言:

張貼留言