本文分享 JavaScript 取得當前年份、星期與時間的常用寫法,並整理 Date 物件的重點方法。
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title></title>
</head>
<body>
</body>
<script type="text/javascript">
// 日期物件可以儲存任意一個日期,並且可以精確到毫秒數(1/1000 秒)。
// 定義一個時間物件:var Udate = new Date();
// 注意:使用關鍵字 new,Date() 的首字母必須大寫。
// 使用 new 之後 Udate 成為日期物件,初始值為當前時間(當前電腦系統時間)。
// 如果要自定義初始值,可以用以下方法:
var d = new Date(2012, 10, 1);
document.write(d + "<br/>");
var c = new Date('Oct 1,2012');
document.write(d + "<br/>");
// 訪問方法語法:「<日期物件><方法>」
// Date 物件中處理時間和日期的常用方法:
// get/setDate(): 返回、設置日期
// get/setFullYear(): 返回、設置年份,用四位數表示
// get/setYear(): 返回、設置年份
// get/setMonth(): 返回、設置月份(0:1月 ... 11:12月)
// get/setHours(): 返回、設置小時,24 小時制
// get/setMinutes(): 返回、設置分鐘數
// get/setSeconds(): 返回、設置秒數
// get/setTime(): 返回、設置時間(毫秒為單位)
// 1. 設置年份方法
// get/setFullYear() 返回/設置年份,用四位數表示
var mydate = new Date(); // 當前時間
document.write(mydate + "<br/>");
document.write(mydate.getFullYear() + "<br/>"); // 輸出當前年份
mydate.setFullYear(81); // 設置年份
document.write(mydate + "<br/>"); // 輸出年份被設定為 81 年
// 注意:不同瀏覽器,mydate.setFullYear(81) 結果不同,
// 年份會被設定為 0081 或 81 兩種情況。
// 結果格式依次為:星期、月、日、年、時、分、秒、時區。(FireFox 瀏覽器)
// 不同瀏覽器,時間格式有差異
// 2. 設置星期的方法
// getDay() 返回星期,返回的是 0-6 的數字,0 表示星期天。
// 如果要返回相對應的「星期」,通過數組完成:
var mydate=new Date();
var weekday=["星期日","星期一","星期二","星期三","星期四","星期五","星期六"];
var mynum=mydate.getDay(); // 返回值存儲在變量 mynum 中
document.write(mydate.getDay()); // 輸出 getDay() 獲取值
document.write("今天是:"+weekday[mynum]); // 輸出星期幾
document.write("<br/>");
// 3. 設置時間方法
// get/setTime() 返回/設置時間,單位毫秒數,
// 計算從 1970 年 1 月 1 日零時到日期物件所指日期的毫秒數。
// 如果將目前日期物件的時間推遲 1 小時:
var mydate=new Date();
document.write("當前時間"+mydate+"<br/>");
mydate.setTime(mydate.getTime()+60*60*1000);
document.write("推遲一小時時間:"+mydate);
// 注意:一小時 60 分,一分 60 秒,一秒 1000 毫秒;
// 時間推遲一小時就是 "x.setTime(x.getTime()+60*60*1000);"
</script>
</html>
月份從 0 開始:new Date(2012, 10, 1) 得到的是 11 月 1 日,不是 10 月。getMonth() 回傳 0~11,所以顯示時一律要 +1。這是新手最常踩的坑。
getDay() 不是 getDate():getDate() 回傳月份中的第幾天(1~31),getDay() 回傳星期(0~6,0 是週日)。範例中把 getDay() 當索引去查表,就能把數字轉成「星期一」這樣的可讀文字。
時間單位是毫秒:所有時間運算都以毫秒為基準,換算關係是 1 秒 = 1000 毫秒、1 分 = 60 秒、1 小時 = 60 分。所以「推遲一小時」就是 setTime(getTime() + 60*60*1000)。
直接 document.write(mydate) 輸出的字串格式其實是依瀏覽器實作而定的,如範例註解所述,各瀏覽器結果並不一致,正式專案不應依賴它。要格式化輸出,建議用 Intl.DateTimeFormat:
new Intl.DateTimeFormat('zh-TW', {
year: 'numeric', month: '2-digit', day: '2-digit',
weekday: 'long', hour: '2-digit', minute: '2-digit'
}).format(new Date());
它會依地區設定輸出本地化的結果,也不必自己拼字串補零。若要處理時區或複雜的日期運算,則可考慮 Temporal API 或 dayjs、date-fns 這類函式庫——直接用 setTime 加減毫秒在跨月、跨日、日光節約時間的情境下容易出錯。