Date 物件為複雜類型之一,僅限於「時間」用途,仍為常用物件,Date 物件能夠表示 1970/01/01 子夜前後 1 億天之內的任何日期與時間(1970/01/01 是電腦常用的一個參考點,被稱為「紀元(Epoch)」或者「UNIX 時間戳記(UNIX Epoch)」)。
參考 MSDN Date 物件:https://msdn.microsoft.com/zh-tw/library/cd9w2te4(v=vs.94).aspx

建立 Date 物件

var 變數名稱 = new:建立運算子 Date()
使用 new 運算子建立物件,產生目前的日期與時間(當 JavaScript 執行於客戶端,是以客戶端機器時間為主)。

var today = new Date();

建立特定日期和時間有三種方式:

1. 使用原子日期值

new Date( year, month, day, hour, minute, second, milliseconds ):年、月、日、時、分、秒、毫秒的原子值

  • 年:XXXX [4 位數]
  • 月:0-11 [1 或 2 位數]
  • 日:1-31 [1 或 2 位數],可選值,預設為 1
  • 小時:0-23 [24 小時制],可選值,未提供值將被設為 00:00:00:(0 毫秒),代表子夜
var someday = new Date(2015, 11, 15, 13, 30);

可單獨提供年、月、日,日期值可有可無,預設為 1,時間值可選,如果指定就可用來設定當天時間。

2. 使用時間戳記

new Date( milliseconds ):時間戳記 ─ UNIX時間戳記前後的秒數或毫秒數

var someday = new Date(86400000 * 10);

從 UNIX 時間戳記開始的毫秒數,由於一天有 86400000 毫秒,可用乘天數方式計算

3. 使用字串

new Date( ‘date string’ ):時間字串,如 July 5,2012

var someday = new Date('03/01/2015 13:30');

字串需為正式的 RFC822/IETF 格式有:
[ July 5,2012 ] [ Jul 5,2012 ] [ 5 July 2012 ] [ 07/05/2012 ] [ 07/05/2012 13:30 ] [ Thu, 05 Jul 2012 13:30:00 GMT-0500 ]
若語法不正確,得到結果會是無效日期或 UNIX 時間戳記(取決於瀏覽器)參考 w3.org RFC822:https://www.w3.org/Protocols/rfc822/

var today = new Date();

var day1 = new Date(2015, 0, 3);
var day2 = new Date(2015, 11, 15, 13, 30);

var day3 = new Date(86400000 * 10);
var day4 = new Date(86400000 * 16425);

var day5 = new Date('03/01/2015 13:30');
var day6 = new Date('Janurary 3,2015');
var day7 = new Date('Mon, 16 May 2016 13:30:00 GMT-0800');

抓取 Date 方法

建立 Date 物件之後可以採多種方法「讀取日期和時間」,回應值皆為數字:

  • .getFullYear(): 返回年份[4 位數]
  • .getMonth(): 返回月份[0-11]
  • .getDate(): 返回日期[1-31]
  • .getDay(): 返回星期[0-6]
  • .getHours(): 返回小時[0-23]
  • .getMinutes(): 返回分鐘[0-59]
  • .getSeconds(): 返回秒數[0-59]
  • .getMilliseconds(): 返回毫秒數[0-999]
  • .getTime(): 返回時間(UNIX 時間戳記算起的毫秒數)

可簡寫為 var getTodayTime = <em><span style="color: #cf2e2e;" class="ugb-highlight">(new Date())</span></em>.getTime;

var today = new Date();
today.getFullYear();
today.getMonth();
today.getDate();
today.getDay();
today.getHours();
today.getMinutes();
today.getSeconds();
today.getMilliseconds();
today.getTime();

輸出字串格式

名稱中帶有「local」的方法按照環境中地區的設定(Locale),回傳格式化的日期和時間。
地區設定是語言、國家和習慣的組合,此一組合影響日期的寫法和數值的格式等,大部分使用者地區設定的特徵由電腦決定,其他特徵則取決於不同瀏覽器。
以下方法返回不同日期和時間格式的字串:

  • .toString(): 傳回日期時間的字串值,字串格式取決於地區設定
  • .toDateString(): 傳回日期的字串值,字串格式取決於地區設定
  • .toTimeString(): 傳回時間的字串值,字串格式取決於地區設定
  • .toLocaleString(): 傳回的日期時間字串值,配合主機環境目前的地區設定或指定的地區設定(Locale)
  • .toLocaleDateString(): 傳回的日期字串值,配合主機環境目前的地區設定或指定的地區設定(Locale)
  • .toLocaleTimeString(): 傳回的時間字串值,配合主機環境目前的地區設定或指定的地區設定(Locale)
  • .toGMTString(): 傳回使用格林威治標準時間(GMT)轉換為字串的日期(此方法不再使用)
  • .toISOString(): 傳回日期的 ISO 格式字串值
  • .toJSON(): 由 JSON.stringify 方法用來轉換物件的資料,以便進行 JavaScript 物件標記法(JSON)序列化

這些方法並非適用所有瀏覽器,像是 .toISOString() 和 .toJSON() 這兩個是 ECMAScript5 新推出的方法,建議採用:

if(today.toJSON){
  //當瀏覽器支援方可使用
}else{
  //不支援時,使用其他方法
}
var today = new Date();
today.toString();             //與 Date() 預設一樣
today.toDateString();
today.toTimeString();
today.toLocaleString();
today.toLocaleDateString();
today.toLocaleTimeString();
today.toGMTString();
today.toISOString();
today.toJSON();

使用時區(UTC)

某些情況下(例如設定拍賣時間)最好使用「中立」的日期時間──在所有客戶端保持一致的日期時間,避免時區不同會造成時間錯誤的狀況,此時會使用標準時區 UTC(Coordinated Universal Time,通用世界時間),和 GMT(Greenwich Mean Time,格林威治時間)相同時區,但目前 UTC 比 GMT 更常使用。

有兩種方式可以建立 UTC:

1. 採用與 UTC 對應的時間戳記

例如拍賣網內容來自資料庫,資料庫資訊使用 UTC,該伺服器便可提供 UTC 時間戳記給 JavaScript,只要 JavaScript 在發送給客戶端之前由伺服端技術(PHP)處理過就有效。

var ending = new Date(<?php echo $timestamp; ?>);

2. 採用字串格式建立日期與時間

此法也可指定時區,擷取本地日期和時間,從原來的 UTC 時間調整為使用者時區的時間。

var ending = new Date('05 Jul 2012 13:30:00 UTC');
var ending = new Date('01 Jul 2020 13:30:00 UTC');
ending.toString();                  //將標準時間轉成當地時間

也可反向從本地端日期時間求得等同於 UTC 的時間:

  • .toUTCString(): 傳回利用全球定位時間(UTC)轉換為字串的日期
  • .getUTCFullYear(): 利用全球定位時間(UTC)取得年份[4 位數]
  • .getUTCMonth(): 使用全球定位時間(UTC)取得月份[0-11]
  • .getUTCDate(): 利用全球定位時間(UTC)取得日期[0-11]
  • .getUTCDay(): 利用全球定位時間(UTC)取得當週的日次[0-6]
  • .getUTCHours(): 使用全球定位時間(UTC)取得小時[0-23]
  • .getUTCMinutes(): 使用全球定位時間(UTC)取得分鐘[0-59]
  • .getUTCSeconds(): 使用全球定位時間(UTC)取得秒數[0-59]
  • .getUTCMilliseconds(): 使用全球定位時間(UTC)取得毫秒數[0-999]
  • .getTimezoneOffset(): 取得本機電腦時間與全球定位時間(UTC)之間的分鐘差
var today = new Date();
today.toUTCString();
today.getUTCFullYear();
today.getUTCMonth();
today.getUTCDate();
today.getUTCDay();
today.getUTCHours();
today.getUTCMinutes();
today.getUTCSeconds();
today.getUTCMilliseconds();
today.getTimezoneOffset();      //依照台灣 +0800 時區,與標準時區相差 8 小時

更改日期

修改 Date 物件表示時間,適用於日期的運算組合,有多種方法可以利用:

  • .setFullYear( 值 ): 利用本地時間設定年份[4 位數]
  • .setMonth( 值 )利用本地時間設定月份[0-11]
  • .setDate(  ): 利用本地時間設定日期[1-31]
  • .setHours(  ): 利用本地時間設定小時[0-23]
  • .setMinutes(  ): 利用本地時間設定分鐘[0-59]
  • .setSeconds(  ): 利用本地時間設定秒數[0-59]
  • .setMilliseconds(  ): 利用本地時間設定毫秒數[0-999]
  • .setTime(  ): 設定 Date 物件中的時間(UNIX 時間戳記算起的毫秒數)
  • .setUTCFullYear(  ): 使用全球定位時間(UTC)設定年份[4 位數]
  • .setUTCMonth(  )使用全球定位時間(UTC)設定月份[0-11]
  • .setUTCDate(  ): 使用全球定位時間(UTC)設定日期[1-31]
  • .setUTCHours(  ): 使用全球定位時間(UTC)設定小時[0-23]
  • .setUTCMinutes(  ): 使用全球定位時間(UTC)設定分鐘[0-59]
  • .setUTCSeconds(  ): 使用全球定位時間(UTC)設定秒數[0-59]
  • .setUTCMilliseconds( 值 ): 利用全球定位時間(UTC)設定毫秒數[0-999]
var date = new Date(2000, 0, 1, 00, 00);
date.setFullYear(2015);
date.setMonth(4, 10);
date.setDate(20);
date.setHours(20);
date.setMinutes(20)
date.setSeconds(35,825);
date.setMilliseconds(192);
date.setTime(1332403882588);

var date2 = new Date(2000, 0, 1, 00, 00);
date2.setUTCFullYear(2015);
date2.setUTCMonth(4, 10);
date2.setUTCDate(20);
date2.setUTCHours(20);
date2.setUTCMinutes(20);
date2.setUTCSeconds(35,825);
date2.setUTCMilliseconds(192);

日期運算

雖然日期沒有乘除運算,但在 JavaScript 裡可以加減運算,有三種方法:

  1. 時間戳記計算:計算兩個日期或時間之間的間隔
  2. 使用 set…() 和 get…():從一個日期加上或減去某段日期或時間
  3. 計算時間間隔:計算從兩個日期之間所花費的時間

※如果只計算間隔(分鐘、小時、日、年),可用 2.,若較為複雜的日期,1. 較為適用

1. 時間戳記計算

有兩種方法抓取時間戳記,再進行計算:

  • 先建立 Date 物件,取得 .getTime() 的時間戳記
  • 利用 .now 函數直接取得現在的時間戳記

.now() 是 ECMASript5 出現的新功能,等同於 Date 物件的 .getTime() 方法,但卻是直接來自 Date 物件本身,如想在舊版瀏覽器使用:

if(Date.now){
    var now = Date.now();
}else{
    var now = (new Date()).getTime();
}

例如計算兩週後的日期時間,時間戳記應為 1000(毫秒)*60(秒)*60(分)*24(時)*14(天):

if(Date.now){
    var now = Date.now();
}else{
    var now = (new Date()).getTime();
}
var interval = 1000*60*60*24*14;        //兩週的時間戳記
var twoWeeks = now + interval;          //兩週後的時間戳記
(new Date(twoWeeks));                   //轉成字串

2. 使用 set…() 和 get…()

透過 get…() 先取得日期/時間,再由 set..() 為日期/時間加上或減去某個時間間隔,慣用語法如下:

var oneday = new Date();
oneday.setDate(oneday.getDate() + 7);           //將目前日期設為一週(7 天)之後
oneday.setHours(oneday.getHours() + 6);         //將目前時間設為 6 小時之後
oneday.setFullYear(oneday.getFullYear() - 1);   //將目前年份設為前 1 年

3. 計算時間間隔

若想求取兩個日期之間的時間間隔(例如拍賣時間減去目前時間的「剩餘時間」),可用日期 1 減日期 2,結果以毫秒表示,不管哪個物件較大,始終為正數。

var dayUnit = 1000 * 60 * 60 * 24;                    //以毫秒作時間單位
var now = new Date();
var someday = new Date('4/6/2015 1:00');

//1. 看現在時間與某天時間還要大或小,要為正數,所以大要減小
if(now > someday){
  var period = Math.round((now - someday)/dayUnit);
}else{
  var period = Math.round((someday - now)/dayUnit);
}

//2. 利用 Math 物件的絕對值
var period2 = Math.abs(Math.round((someday - now)/dayUnit));

參考或引用資料:

Date 物件:http://test.domojyun.net/MEMO/JavaScript/3_date.html

本文整理內容參考《JavaScript 設計與開發 透視新技術關鍵+完全實力養成》此書,純屬個人學習整理分享,非商業用途
本書作者:LarryUllman

以上內容純屬個人學習整理分享,學術使用,非商業用途,如有任何侵權 ,請告知,立即刪除。

Steven玄

謝謝您觀看本站內容!! 希望文章內容有幫助到你!! 西元93年台灣男,努力成為優秀的軟體工程師 和 創造多元收入,較常執行於 程式撰寫、網站系統架設規劃 和 商業策略分析規劃,目前在網站開發公司擔任工程師。

發佈留言