萬盛學電腦網

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

JavaScript Date.setSeconds() 方法:設置秒數與毫秒

Date.setSeconds() 方法簡介

Date.prototype.setSeconds() 根據**本地時間**設置 Date 對象的**秒數**,可選同時設置毫秒。返回更新後的時間戳(毫秒數)。

語法

dateObj.setSeconds(secondsValue[, msValue])

參數詳解

參數範圍說明
secondsValue0-59**必填**。秒數
msValue0-999可選。毫秒數。若提供,必須同時提供 secondsValue

返回值

更新後的時間戳(Number),非 Date 對象。

代碼示例

const dt = new Date('Aug 28, 2008 23:30:00');
console.log('原始:', dt.toString()); // Thu Aug 28 2008 23:30:00 GMT+0800

// 僅設置秒
dt.setSeconds(30);
console.log('setSeconds(30):', dt.toString()); // Thu Aug 28 2008 23:30:30 GMT+0800

// 同時設置秒、毫秒
dt.setSeconds(45, 500);
console.log('setSeconds(45,500):', dt.toString()); // Thu Aug 28 2008 23:30:45.500 GMT+0800

自動進位/借位機制

const dt = new Date('2024-01-01 12:00:00');

dt.setSeconds(70);  // 70秒 = 1分10秒
console.log(dt.toString()); // 2024-01-01 12:01:10 (分鐘+1)

dt.setSeconds(-10); // -10秒 = 借1分鐘 = 50秒
console.log(dt.toString()); // 2024-01-01 11:59:50 (分鐘-1)

dt.setSeconds(30, 1500); // 1500毫秒 = 1.5秒 → 31秒500毫秒
console.log(dt.toString()); // 2024-01-01 11:59:31.500

實戰應用場景

1. 時間對齊(對齊到整分鐘/整 10 秒)

function alignToMinute(date = new Date()) {
    date.setSeconds(0, 0);
    return date;
}

function alignTo10Seconds(date = new Date()) {
    const seconds = date.getSeconds();
    const aligned = Math.round(seconds / 10) * 10;
    date.setSeconds(aligned, 0);
    return date;
}

2. 高精度時間戳生成

function preciseTimestamp() {
    const now = new Date();
    // 手動設置毫秒以獲得一致性(如日誌系統)
    now.setMilliseconds(0); // 或保留實際毫秒
    return now.getTime();
}

// 配合 performance.now() 獲取亞毫秒精度
function highResTimestamp() {
    const base = new Date();
    base.setMilliseconds(0);
    return base.getTime() + performance.now();
}

3. 定時器校準

// 消除 setInterval 累積誤差:每次校準到下一個整秒
function preciseInterval(fn, intervalMs = 1000) {
    const nextTick = Date.now() + intervalMs;
    const timer = setTimeout(function tick() {
        fn();
        const now = Date.now();
        const drift = now - nextTick;
        const nextDelay = intervalMs - drift;
        setTimeout(tick, Math.max(0, nextDelay));
    }, intervalMs);
    return () => clearTimeout(timer);
}

UTC 版本:setUTCSeconds()

const dt = new Date();
dt.setUTCSeconds(30, 500);
console.log(dt.toISOString()); // UTC 時間反映變化

注意事項

  • 返回時間戳:不可鏈式調用 date.setSeconds(30).setMilliseconds(0) ❌
  • 參數依賴順序:提供毫秒必須提供秒
  • 本地時間操作:修改本地秒數,內部 UTC 時間戳同步更新
  • 批量修改建議:一次性構造新 Date 對象 new Date(y, m, d, h, min, sec, ms),避免多次 setter 觸發重算

相關方法速查

方法設置分量UTC 版本
setHours()時、分、秒、毫秒setUTCHours()
setMinutes()分、秒、毫秒setUTCMinutes()
setSeconds()秒、毫秒setUTCSeconds()
setMilliseconds()毫秒setUTCMilliseconds()
setTime(ms)時間戳(毫秒)-

setSeconds() 配合自動進位特性,是實現時間對齊、精確定時、高精度時間戳的基礎工具。現代代碼中常與 Date.now()、performance.now() 結合使用。

copyright © 萬盛學電腦網 all rights reserved