萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

JavaScript 即時時鐘在表單顯示:Date API、setInterval 輪詢與生命週期管理完整範例

在表單輸入框 (<input>) 中即時顯示當前日期時間 (含年月日、星期、12小時制 AM/PM),是早期 Web 頁面常見功能。本文提供標準化、無記憶體洩漏、支援清理機制的完整實作,並說明現代化改良方向。

核心實作代碼

HTML 結構

<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 字體保證字元等寬對齊。

JavaScript 邏輯 (置於 <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>

關鍵技術點解析

1. IIFE (立即調用函數表達式) 封裝作用域

避免污染全域命名空間,變數 timerId、isRunning 形成閉包,外部無法直接竄改。

2. 防禦性程式設計

  • document.forms['jsfrm']?.elements['face']:選用鏈判斷,元素不存在時優雅失敗
  • if (!inputEl) return;:早期返回,避免後續報錯
  • hours24 % 12 || 12:巧妙處理 0 時 → 12 時 (12小時制)

3. 雙重清理機制

  • beforeunload:頁面關閉/跳轉時清理
  • visibilitychange:切換分頁/最小化時暫停,回來恢復 —— **節省背景分頁 CPU/電量**

4. 公開控制器 API

window.clockController = { start, stop, update }

方便除錯、測試、或其他腳本協調控制 (如:用戶登入後重新同步時間)。

現代化改良:requestAnimationFrame 高精度版

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);
}

伺服器端時間同步 (NTP 模式)

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 組件,納入設計系統統一管理。

copyright © 萬盛學電腦網 all rights reserved