Date 日期和時間物件
1. 介紹
Date 物件是專門用來操作日期和時間的物件,對日期和時間的操作只能透過方法進行。
2. 建構函數
2.1 new Date():返回當前的本地日期和時間,無參數,回傳一個表示本地日期和時間的 Date 物件。
var dt = new Date(); console.log(dt); // => 返回一個表示本地日期和時間的 Date 物件
2.2 new Date(milliseconds):把毫秒數轉換為 Date 物件。參數 milliseconds 為毫秒數,表示從 '1970/01/01 00:00:00' 為起點開始疊加的毫秒數。注意:起點的時分秒還要加上當前所在的時區,北京時間的時區為東 8 區,起點時間實際為 '1970/01/01 08:00:00'。
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:002.3 new Date(dateStr):把字串轉換為 Date 物件。參數 dateStr 為可轉換為 Date 物件的字串(可省略時間),格式主要有兩種:
1) yyyy/MM/dd HH:mm:ss(推薦):若省略時間,回傳的 Date 物件時間為 00:00:00。
2) yyyy-MM-dd HH:mm:ss:若省略時間,回傳的 Date 物件時間為 08:00:00(加上本地時區);若不省略時間,此字串在 IE 中會轉換失敗!
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:002.4 new Date(year, month, opt_day, opt_hours, opt_minutes, opt_seconds, opt_milliseconds):把年月日、時分秒轉換為 Date 物件。參數依次為:year(4 位年份)、month(月份,從 0 開始計算,0 表示 1 月、11 表示 12 月)、opt_day(可選,日,從 1 開始)、opt_hours(可選,時,0~23)、opt_minutes(可選,分,0~59)、opt_seconds(可選,秒,0~59)、opt_milliseconds(可選,毫秒,0~999)。
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); // 月份數字為12,表示第13個月,跳轉到第二年的1月 console.log(dt); // => {Date}:2015/01/253. 屬性
無;Date 物件對日期和時間的操作只能透過方法進行。
4. 實例方法
Date 物件的實例方法主要分為兩種形式:本地時間和 UTC 時間。同一個方法一般都會有這兩種時間格式操作(方法名帶 UTC 的即操作 UTC 時間),這裡主要介紹對本地時間的操作。
4.1 get 方法
getFullYear():回傳年份值(4 位年份)。
getMonth():回傳月份值,從 0 開始,所以真實月份 = 回傳值 + 1。
getDate():回傳月份中的日期值,範圍 1~31。
getHours():回傳小時值。
getMinutes():回傳分鐘值。
getSeconds():回傳秒數值。
getMilliseconds():回傳毫秒值。
getDay():回傳一週中的星期值,0 為星期天,1 為星期一,以此類推。
getTime():回傳 Date 物件與 '1970/01/01 00:00:00' 之間的毫秒值(北京時間起點實際為 '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
4.2 set 方法
setFullYear(year, opt_month, opt_date):設置年份值。
setMonth(month, opt_date):設置月份值,0 表示 1 月,11 表示 12 月。
setDate(date):設置月份中的日期值,範圍 1~31。
setHours(hour, opt_min, opt_sec, opt_msec):設置小時值。
setMinutes(min, opt_sec, opt_msec):設置分鐘值。
setSeconds(sec, opt_msec):設置秒數值。
setMilliseconds(msec):設置毫秒值。
var dt = new Date(); dt.setFullYear(2014); // => 2014:年 dt.setMonth(11); // => 11:月;實際為12月份 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 其他方法
toString():將 Date 轉換為一個「年月日 時分秒」字串。
toLocaleString():將 Date 轉換為一個「年月日 時分秒」的本地格式字串。
toDateString():將 Date 轉換為一個「年月日」字串。
toLocaleDateString():將 Date 轉換為一個「年月日」的本地格式字串。
toTimeString():將 Date 轉換為一個「時分秒」字串。
toLocaleTimeString():將 Date 轉換為一個「時分秒」的本地格式字串。
valueOf():與 getTime() 一樣,回傳 Date 物件與起始時間之間的毫秒值。
var dt = new Date(); console.log(dt.toString()); // => Tue Dec 23 2014 22:56:11 GMT+0800 (中國標准時間) console.log(dt.toLocaleString()); // => 2014年12月23日 下午10:56:11 console.log(dt.toDateString()); // => Tue Dec 23 2014 console.log(dt.toLocaleDateString()); // => 2014年12月23日 console.log(dt.toTimeString()); // => 22:56:11 GMT+0800 (中國標准時間) console.log(dt.toLocaleTimeString()); // => 下午10:56:11 console.log(dt.valueOf()); // => 返回毫秒值
5. 靜態方法
5.1 Date.now():返回當前日期和時間的 Date 物件與起始時間之間的毫秒值,無參數。
console.log(Date.now()); // => 1419431519276
5.2 Date.parse(dateStr):把字串轉換為 Date 物件,然後返回此 Date 物件與起始時間之間的毫秒值。字串格式說明同 2.3(yyyy-MM-dd HH:mm:ss 在 IE 中會返回 NaN)。
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 的值與起始時間之間的毫秒數。
// 前台代碼 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 {String}:返回倒計時: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,表示目的時間小於當前時間,此時取的值都是負的 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 物件的大小
可以對比兩者與起始時間的毫秒數來區分大小。
var dt1 = new Date('2015/12/01'); var dt2 = new Date('2015/12/25'); console.log(dt1 > dt2); // => false