萬盛學電腦網

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

JavaScript Date.setMinutes() 方法:設置日期對象分鐘數

Date.setMinutes() 方法簡介

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

語法

dateObj.setMinutes(minutesValue[, secondsValue[, msValue]])

參數詳解

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

返回值

更新後的時間戳(自 UTC 1970-01-01 00:00:00 的毫秒數),**非 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.setMinutes(45);
console.log('setMinutes(45):', dt.toString()); // Thu Aug 28 2008 23:45:00 GMT+0800

// 同時設置分、秒
dt.setMinutes(30, 30);
console.log('setMinutes(30,30):', dt.toString()); // Thu Aug 28 2008 23:30:30 GMT+0800

// 同時設置分、秒、毫秒
dt.setMinutes(0, 0, 500);
console.log('setMinutes(0,0,500):', dt.toString()); // Thu Aug 28 2008 23:00:00.500 GMT+0800

自動進位/借位機制

參數超出範圍會自動向高位進位或向低位借位:

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

dt.setMinutes(70);  // 70分 = 1時10分
console.log(dt.toString()); // 2024-01-01 13:10:00 (小時+1)

dt.setMinutes(-10); // -10分 = 借1小時 = 50分
console.log(dt.toString()); // 2024-01-01 12:50:00 (小時-1)

dt.setMinutes(0, 120); // 120秒 = 2分
console.log(dt.toString()); // 2024-01-01 12:52:00

實戰應用場景

1. 時間對齊(如對齊到最近 15 分鐘)

function alignTo15Min(date = new Date()) {
    const minutes = date.getMinutes();
    const aligned = Math.round(minutes / 15) * 15;
    date.setMinutes(aligned, 0, 0); // 秒、毫秒歸零
    return date;
}
console.log(alignTo15Min(new Date('2024-10-15 10:07'))); // 10:00
console.log(alignTo15Min(new Date('2024-10-15 10:08'))); // 10:15

2. 定時任務下次執行時間計算

function nextRunAt(cronMinutes) { // 如 "0,15,30,45"
    const now = new Date();
    const minutes = now.getMinutes();
    const targets = cronMinutes.split(',').map(Number).sort((a,b)=>a-b);
    const next = targets.find(m => m > minutes) || targets[0] + 60;
    const diff = next - minutes;
    now.setMinutes(now.getMinutes() + diff, 0, 0);
    return now;
}

3. 表單時間選擇器同步

<input type="time" id="timeInput" value="14:30">

$('#timeInput').on('change', function() {
    const [h, m] = this.value.split(':').map(Number);
    const dt = new Date(); // 今天
    dt.setHours(h);
    dt.setMinutes(m, 0, 0);
    console.log('選擇時間:', dt.toLocaleTimeString());
});

UTC 版本:setUTCMinutes()

const dt = new Date();
dt.setUTCMinutes(30); // 設置 UTC 分鐘
console.log(dt.toISOString()); // UTC 時間反映變化

注意事項

  • 返回時間戳:非 Date 對象,鏈式調用需注意:date.setMinutes(30).setSeconds(0) ❌
  • 本地時間:操作本地時間分量,內部 UTC 時間戳相應改變
  • 參數依賴順序:提供秒必須提供分,提供毫秒必須提供分、秒
  • 避免在循環中重複調用:每次調用都會重新計算內部時間戳,批量修改建議一次性計算好所有分量再調用

相關方法

  • setHours() - 設置小時(可連帶分、秒、毫秒)
  • setSeconds() - 設置秒
  • setMilliseconds() - 設置毫秒
  • setTime(ms) - 直接設置時間戳
  • 對應 UTC 版本:setUTCHours()、setUTCMinutes() 等

setMinutes() 是精確控制時間分鐘分量的標準方法,配合自動進位特性,能優雅處理時間對齊、定時計算等常見需求。

copyright © 萬盛學電腦網 all rights reserved