在表單輸入框 (<input>) 中即時顯示當前日期時間 (含年月日、星期、12小時制 AM/PM),是早期 Web 頁面常見功能。本文提供標準化、無記憶體洩漏、支援清理機制的完整實作,並說明現代化改良方向。
<form name="jsfrm">
<input type="text" name="face" size="40" value="" readonly
style="font-family: 'Consolas', monospace; font-size: 14px; padding: 8px; border: 1px solid #ccc; border-radius: 4px;">
</form>
關鍵屬性:readonly 防止用戶手動修改,monospace 字體保證字元等寬對齊。
<body> 結尾或 DOMContentLoaded)<script>
(function() {
'use strict';
// 週名稱陣列 (索引 0=星期日)
const WEEK_DAYS = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
// 狀態變數
let timerId = null;
let isRunning = false;
// 取得表單輸入元素
const inputEl = document.forms['jsfrm']?.elements['face'];
if (!inputEl) {
console.error('找不到表單元素: document.forms.jsfrm.face');
return;
}
// 格式化時間字串
function formatDateTime(date) {
const year = date.getFullYear();
const month = String(date.getMonth() + 1).padStart(2, '0');
const day = String(date.getDate()).padStart(2, '0');
const hours24 = date.getHours();
const hours12 = hours24 % 12 || 12; // 0 轉 12
const minutes = String(date.getMinutes()).padStart(2, '0');
const seconds = String(date.getSeconds()).padStart(2, '0');
const ampm = hours24 < 12 ? '上午' : '下午';
const week = WEEK_DAYS[date.getDay()];
// 格式:2024年12月25日 星期三 02:30:05 下午
return `${year}年${month}月${day}日 ${week} ${String(hours12).padStart(2,'0')}:${minutes}:${seconds} ${ampm}`;
}
// 更新顯示
function updateDisplay() {
const now = new Date();
inputEl.value = formatDateTime(now);
}
// 啟動時鐘
function startClock() {
if (isRunning) return; // 防止重複啟動
stopClock(); // 確保清理舊定時器
updateDisplay(); // 立即顯示一次
timerId = setInterval(updateDisplay, 1000);
isRunning = true;
}
// 停止時鐘
function stopClock() {
if (timerId) {
clearInterval(timerId);
timerId = null;
}
isRunning = false;
}
// 頁面載入啟動
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', startClock);
} else {
startClock();
}
// 頁面卸載/隱藏時清理
window.addEventListener('beforeunload', stopClock);
document.addEventListener('visibilitychange', () => {
if (document.hidden) stopClock();
else startClock();
});
// 公開 API (供外部控制)
window.clockController = { start: startClock, stop: stopClock, update: updateDisplay };
})();
</script>
避免污染全域命名空間,變數 timerId、isRunning 形成閉包,外部無法直接竄改。
document.forms['jsfrm']?.elements['face']:選用鏈判斷,元素不存在時優雅失敗if (!inputEl) return;:早期返回,避免後續報錯hours24 % 12 || 12:巧妙處理 0 時 → 12 時 (12小時制)beforeunload:頁面關閉/跳轉時清理visibilitychange:切換分頁/最小化時暫停,回來恢復 —— **節省背景分頁 CPU/電量**window.clockController = { start, stop, update }
方便除錯、測試、或其他腳本協調控制 (如:用戶登入後重新同步時間)。
function startClockRAF() {
let lastTime = 0;
function tick(time) {
if (!isRunning) return;
// 節流:僅每秒更新一次 (避免過度重繪)
if (time - lastTime >= 1000) {
updateDisplay();
lastTime = time;
}
timerId = requestAnimationFrame(tick);
}
timerId = requestAnimationFrame(tick);
isRunning = true;
}
function stopClockRAF() {
cancelAnimationFrame(timerId);
isRunning = false;
}
優點:與瀏覽器重繪同步、無定時器誤差累積、自動暫停於背景分頁。
function formatDateTimeTZ(date, timeZone = 'Asia/Taipei') {
return new Intl.DateTimeFormat('zh-TW', {
timeZone, year: 'numeric', month: '2-digit', day: '2-digit',
hour: '2-digit', minute: '2-digit', second: '2-digit',
hour12: true, weekday: 'long'
}).format(date);
}
async function syncServerTime() {
const start = performance.now();
const res = await fetch('/api/time'); // 回傳 { serverTime: 'ISO8601' }
const latency = (performance.now() - start) / 2;
const serverTime = new Date(res.serverTime);
serverTime.setMilliseconds(serverTime.getMilliseconds() + latency);
// 計算本地與伺服器偏移量,後續顯示時套用偏移
window.timeOffset = serverTime - new Date();
}
| 現象 | 可能原因 | 解決 |
|---|---|---|
| 時鐘停止/凍結 | 定時器被清理、主執行緒長時間阻塞 | 檢查 visibilitychange 處理、避免長任務阻塞主執行緒 |
| 時間跳躍/重複 | 多重 setInterval 同時運行 | 啟動前必須 stopClock()、使用 isRunning 旗標 |
| 秒數不準 | setInterval 最小間隔 4ms (背景分頁 1000ms),誤差累積 | 改用 requestAnimationFrame + 時間戳校準、或 Web Worker |
| 輸入框可編輯 | 缺少 readonly 屬性 | 加上 readonly、或用 <output> / <div> 替代 |
| 字體對齊錯亂 | 比例字體寬度不固定 | 指定 monospace 字體族 (Consolas, Monospace, Menlo) |
表單即時時鐘雖屬基礎功能,但完整實作需考量:**生命週期管理 (啟動/停止/清理)、背景分頁資源節約、錯誤容錯、精度控制、時區支援、無障礙**。現代專案建議採用 requestAnimationFrame + Intl.DateTimeFormat + Visibility API 組合,並封裝為可復用的 Web Component 或 React/Vue/Svelte 組件,納入設計系統統一管理。