先看一段看起來很合理、實際卻不會動的程式碼:
$(function(){
setInterval(function(){
var timer = '<?php echo date("Y-m-d H:i:s", time()) ?>';
$("#test").append(timer);
}, 500);
});
很多人第一次寫動態時鐘都會踩這個坑:畫面上確實在不斷追加文字,但時間永遠停在頁面產生的那一刻。
關鍵在於 PHP 與 JavaScript 的執行位置不同。PHP 是伺服器端語言,請求進來時就已經被 interpreter 完整解析成純文字;瀏覽器收到的回應裡,那段 <?php ?> 早已消失,只剩下:
$(function(){
setInterval(function(){
var timer = '2015-01-02 12:02:02';
$("#test").append(timer);
}, 500);
});
也就是說,setInterval 每 500 毫秒呼叫一次的那個函式,裡頭的字串是一個固定的常數。它不會自己變,當然怎麼跑都是同一個時間。伺服器端語言只在「產出頁面時」執行一次,之後便與瀏覽器無關了。
順帶一提,範例用 append 也有問題:時間會一直往下堆疊成瀑布,正確做法應該是 text() 或 html() 覆寫。
即時時鐘應該由前端自己算。先擴充 Date 的格式化能力:
// 對 Date 的擴充:轉為指定格式的字串
// 月(M)、日(d)、小時(h)、分(m)、秒(s)、季度(q) 可用 1-2 個占位符
// 年(y) 可用 1-4 個占位符,毫秒(S) 只能用 1 個占位符
// 例:(new Date()).Format("yyyy-MM-dd hh:mm:ss.S") ==> 2006-07-02 08:09:04.423
Date.prototype.Format = function (fmt) {
var o = {
"M+": this.getMonth() + 1, // 月份
"d+": this.getDate(), // 日
"h+": this.getHours(), // 小時
"m+": this.getMinutes(), // 分
"s+": this.getSeconds(), // 秒
"q+": Math.floor((this.getMonth() + 3) / 3), // 季度
"S": this.getMilliseconds() // 毫秒
};
if (/(y+)/.test(fmt)) {
fmt = fmt.replace(RegExp.$1, (this.getFullYear() + "").substr(4 - RegExp.$1.length));
}
for (var k in o) {
if (new RegExp("(" + k + ")").test(fmt)) {
fmt = fmt.replace(RegExp.$1,
(RegExp.$1.length == 1) ? (o[k]) : (("00" + o[k]).substr(("" + o[k]).length)));
}
}
return fmt;
};
$(function(){
setInterval(function(){
var timer = new Date().Format("yyyy-MM-dd HH:mm:ss");
$("#test").text(timer); // 用 text 覆寫,避免內容堆疊
}, 1000);
});
1. 請勿直接擴充原生 prototype。 上面的寫法只是為了呼應範例,在真實專案裡,尤其團隊協作或載入了多個第三方套件時,污染 Date.prototype 很容易與其他函式庫互搶名稱。改用獨立工具函式 formatDate(date, fmt) 會安全得多。
2. 該用哪個時間基準? 瀏覽器取到的是使用者本機時間,使用者改系統時鐘就會顯示錯誤。若頁面對時間準確度有要求(例如倒數搶購、簽到),應以伺服器時間為基準計算偏移量,再用 Date.now() 加上差值自行推進,而不是每分鐘回伺服器問一次。同時提醒:setInterval 在分頁被切到背景時會被瀏覽器節流,回到前景可能出現跳動,必要時監聽 visibilitychange 補一次同步。
釐清「伺服器端渲染一次、客戶端持續執行」這條界線,這類問題就不容易再犯。