Date.prototype.setMinutes() 根據**本地時間**設置 Date 對象的**分鐘**,可選同時設置秒、毫秒。返回更新後的時間戳(毫秒數)。
dateObj.setMinutes(minutesValue[, secondsValue[, msValue]])
| 參數 | 範圍 | 說明 |
|---|---|---|
minutesValue | 0-59 | **必填**。分鐘數 |
secondsValue | 0-59 | 可選。秒數。若提供,必須同時提供 minutesValue |
msValue | 0-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
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
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;
}
<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());
});
const dt = new Date();
dt.setUTCMinutes(30); // 設置 UTC 分鐘
console.log(dt.toISOString()); // UTC 時間反映變化
date.setMinutes(30).setSeconds(0) ❌setHours() - 設置小時(可連帶分、秒、毫秒)setSeconds() - 設置秒setMilliseconds() - 設置毫秒setTime(ms) - 直接設置時間戳setUTCHours()、setUTCMinutes() 等setMinutes() 是精確控制時間分鐘分量的標準方法,配合自動進位特性,能優雅處理時間對齊、定時計算等常見需求。