日期與時間的操作幾乎每個專案都躲不掉,而 Date 就是 JavaScript 的 answer。本文系統性地整理它的建構方式、實例方法、靜態方法,並補上幾個實務上常用的操作範例。
Date 是操作日期與時間的物件,值得注意的是它沒有公開屬性,所有操作都必須透過方法進行。
new Date():取得當前時間不傳參數,回傳一個表示本地日期與時間的 Date 物件。
var dt = new Date(); console.log(dt); // => 當前本地日期與時間
new Date(milliseconds):毫秒數轉 Date參數是從 1970/01/01 00:00:00 起算的毫秒數,可正可負。
注意:起點還要加上本地時區,東八區的實際起點是 1970/01/01 08:00:00。
var dt = new Date(1000 * 60 * 1); // 前進 1 分鐘 console.log(dt); // => 1970/01/01 08:01:00 dt = new Date(-1000 * 60 * 1); // 倒退 1 分鐘 console.log(dt); // => 1970/01/01 07:59:00
new Date(dateStr):字串轉 Date可省略時間部分。字串格式主要有兩種:
yyyy/MM/dd HH:mm:ss(推薦):省略時間時,結果為 00:00:00。yyyy-MM-dd HH:mm:ss:省略時間時,結果為 08:00:00(補上本地時區);若不省略時間,此寫法在 IE 會轉換失敗。var dt = new Date('2014/12/25');
console.log(dt); // => 2014/12/25 00:00:00
dt = new Date('2014/12/25 12:00:00');
console.log(dt); // => 2014/12/25 12:00:00
dt = new Date('2014-12-25');
console.log(dt); // => 2014-12-25 08:00:00(加上了東八區時區)
dt = new Date('2014-12-25 12:00:00');
console.log(dt); // => 此轉換方式在 IE 中會報錯!
new Date(year, month, day, hours, minutes, seconds, ms)以前兩個參數為必填,其餘可選:
year:4 位數年份,如 1999、2014month:從 0 起算,0 是 1 月、11 是 12 月day:從 1 起算,取值 1~31hours:0~23;minutes/seconds:0~59;ms:0~999var dt = new Date(2014, 11); // 2014 年 12 月 console.log(dt); // => 2014/12/01 00:00:00 dt = new Date(2014, 11, 25); // 2014 年 12 月 25 日 console.log(dt); // => 2014/12/25 00:00:00 dt = new Date(2014, 11, 25, 15, 30, 40); console.log(dt); // => 2014/12/25 15:30:40 dt = new Date(2014, 12, 25); // 月份填 12,等於第 13 個月,自動跨到隔年 console.log(dt); // => 2015/01/25
最後一個例子說明了 Date 的一個特性:超出範圍的數值會自動進位,這既是陷阱也是工具。
實例方法大致分兩組:本地時間與 UTC 時間。同名的方法若加上 UTC 前綴就是操作 UTC 時間,以下聚焦在本地時間。
dt.getFullYear(); // => 2014:年(4 位數) dt.getMonth(); // => 11:月(從 0 起算,實際是 12 月) dt.getDate(); // => 25:日(1~31) dt.getHours(); // => 15:時 dt.getMinutes(); // => 30:分 dt.getSeconds(); // => 40:秒 dt.getMilliseconds(); // => 333:毫秒 dt.getDay(); // => 4:星期(0 是週日,1 是週一,依此類推) dt.getTime(); // => 1419492640333:與 1970/01/01 00:00:00 相差的毫秒數
var dt = new Date(); dt.setFullYear(2014); // 年 dt.setMonth(11); // 月(0 起算,這裡是 12 月) dt.setDate(25); // 日 dt.setHours(15); // 時 dt.setMinutes(30); // 分 dt.setSeconds(40); // 秒 dt.setMilliseconds(333); // 毫秒 console.log(dt); // => 2014 年 12 月 25 日 15 點 30 分 40 秒 333 毫秒
var dt = new Date(); dt.toString(); // => Tue Dec 23 2014 22:56:11 GMT+0800(中國標準時間) dt.toLocaleString(); // => 2014年12月23日 下午10:56:11 dt.toDateString(); // => Tue Dec 23 2014 dt.toLocaleDateString(); // => 2014年12月23日 dt.toTimeString(); // => 22:56:11 GMT+0800(中國標準時間) dt.toLocaleTimeString(); // => 下午10:56:11 dt.valueOf(); // => 同 getTime(),回傳毫秒數
Date.now()回傳目前時間與起始時間之間的毫秒數,不接受參數。
console.log(Date.now()); // => 1419431519276
Date.parse(dateStr)把字串轉為 Date 之後,回傳它與起始時間之間的毫秒數。格式規則與 new Date(str) 相同:yyyy/MM/dd HH:mm:ss 較保險;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!)
C# 的 DateTime 經由 JSON 序列化後,格式長得像 "\/Date(1419492640000)\/",括號中的數字就是與起始時間相差的毫秒數。
後端(簡單的 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
/**
* 回傳剩餘時間
* @param dt {Date} 目標時間
* @return {String} 形如「X天X時X分」
*/
function getDownTime(dt) {
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);
// 若目標時間已過去,毫秒差為負,此時把時、分也轉負
if (intervalMsec < 0) {
hour = 0 - hour;
min = 0 - min;
}
return day + '天' + hour + '時' + min + '分';
}
// 假設現在是 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分
由於 Date 物件在比較時會轉成毫秒數,可以直接用 >/< 運算子:
var dt1 = new Date('2015/12/01');
var dt2 = new Date('2015/12/25');
console.log(dt1 > dt2); // => false
以上就是本文的全部內容,希望對大家的學習有所幫助。