萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 精確倒計時實現:雙模式代碼詳解與最佳實踐

項目背景

本文提供兩套倒計時實現:基於 setInterval 的簡潔版與基於 setTimeout 遞歸的服務端時間同步版。適用於秒殺、考試、活動頁等對時間精度有要求的場景。

模式一:標準 setInterval 版(推薦大多數場景)

<div id="demo01" class="colockbox">
    剩余 <i class="day">0</i>天
    <i class="hour">0</i>時
    <i class="minute">0</i>分
    <i class="second">0</i>秒
    <input id="end_time_gou" type="hidden" value="2025/12/31 23:59:59">
    <input id="now_gou" type="hidden" value="2025/01/15 10:30:00">
</div>

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
function countDown(endTimeStr, nowTimeStr, daySel, hourSel, minSel, secSel) {
    const endTime = new Date(endTimeStr).getTime();
    const nowTime = new Date(nowTimeStr).getTime();
    let diffSec = Math.max(0, Math.floor((endTime - nowTime) / 1000));

    const timer = setInterval(() => {
        if (diffSec <= 0) {
            clearInterval(timer);
            return;
        }
        diffSec--;

        const day = Math.floor(diffSec / 86400);
        const hour = Math.floor((diffSec % 86400) / 3600);
        const minute = Math.floor((diffSec % 3600) / 60);
        const second = diffSec % 60;

        $(daySel).text(day);
        $(hourSel).text(hour.toString().padStart(2, '0'));
        $(minSel).text(minute.toString().padStart(2, '0'));
        $(secSel).text(second.toString().padStart(2, '0'));
    }, 1000);
}

// 調用
countDown(
    $('#end_time_gou').val(),
    $('#now_gou').val(),
    '#demo01 .day', '#demo01 .hour', '#demo01 .minute', '#demo01 .second'
);
</script>

模式二:服務端時間同步版(高精度需求)

解決客戶端時間不準、用戶修改系統時間導致倒計時不準確的問題:

<div id="timer" class="colockbox"></div>

<script>
// 服務端時間戳(毫秒)
const serverTime = new Date($('#now_gou').val()).getTime();
// 客戶端時間戳
const clientTime = Date.now();
// 時間偏移量
const offset = serverTime - clientTime;

const endTime = new Date($('#end_time_gou').val()).getTime();

function showTime() {
    const now = Date.now() + offset; // 校準後的當前時間
    const diff = endTime - now;

    if (diff <= 0) {
        $('#timer').text('已結束');
        return;
    }

    const day = Math.floor(diff / 86400000);
    const hour = Math.floor((diff % 86400000) / 3600000);
    const minute = Math.floor((diff % 3600000) / 60000);
    const second = Math.floor((diff % 60000) / 1000);

    $('#timer').text(
        `${day}天${hour.toString().padStart(2,'0')}時${minute.toString().padStart(2,'0')}分${second.toString().padStart(2,'0')}秒`
    );

    setTimeout(showTime, 1000);
}

showTime();
</script>

關鍵技術點解析

技術點說明
時間戳統一全部使用 getTime() 獲取毫秒級時間戳,避免 Date 對象運算陷阱
服務端校準記錄 serverTime - clientTime 偏移,後續所有時間加上偏移量
padStart 補零ES2017 String.padStart(2,'0') 替代三元運算符,代碼更優雅
setTimeout 遞歸比 setInterval 更精確,避免執行時間導致的誤差累積
邊界保護Math.max(0, ...) 防止負值導致邏輯錯誤

進階優化建議

  • Web Worker:將計時邏輯移至 Worker 線程,避免主線程阻塞影響精度
  • requestAnimationFrame:配合時間戳檢查實現更平滑的秒級更新
  • 可見性 API:頁面隱藏時暫停,顯示時重新同步:document.addEventListener('visibilitychange', ...)
  • 防抖渲染:僅在數值真正變化時更新 DOM,減少重繪
  • 國際化:使用 Intl.DateTimeFormat 或 i18n 庫處理多語言

常見坑點提醒

  1. 月份陷阱:new Date(2025, 5, 1) 月份是 0-11,字符串解析 new Date('2025/06/01') 月份是 1-12
  2. 時區問題:服務端建議返回 UTC 時間戳(毫秒數),前端統一處理
  3. 內存洩漏:組件銷毀時必須 clearInterval/clearTimeout
  4. 並發調用:同頁多個倒計時共用一個定時器,統一分發更新

總結

普通場景用 setInterval 版本即可,代碼簡潔易維護;高精度、防作弊場景必須採用服務端時間同步方案。現代語法(padStart、箭頭函數、解構)能顯著提升代碼可讀性。

copyright © 萬盛學電腦網 all rights reserved