Date.prototype.setUTCMinutes()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

setUTCMinutes() 方法用於更改 Date 例項的分鐘數,以協調世界時(UTC)為準。

試一試

const date = new Date("December 31, 1975, 23:15:30 GMT+11:00");

console.log(date.getUTCMinutes());
// Expected output: 15

date.setUTCMinutes(25);

console.log(date.getUTCMinutes());
// Expected output: 25

語法

js
setUTCMinutes(minutesValue)
setUTCMinutes(minutesValue, secondsValue)
setUTCMinutes(minutesValue, secondsValue, msValue)

引數

minutesValue

一個介於 0 和 59 之間的整數,表示分鐘數。

secondsValue 可選

一個介於 0 和 59 之間的整數,表示秒數。如果指定了 secondsValue,則必須同時指定 minutesValue

msValue 可選

一個介於 0 和 999 之間的整數,表示毫秒數。如果指定了 msValue,則必須同時指定 minutesValuesecondsValue

返回值

該方法會直接修改 Date 物件,並返回其新的 時間戳。如果某個引數是 NaN(或被 強制轉換NaN 的值,如 undefined),則日期將設定為 無效日期,並返回 NaN

描述

如果您未指定 secondsValuemsValue 引數,則將使用從 getUTCSeconds()getUTCMilliseconds() 方法返回的值。

如果您指定的引數超出了預期範圍,setUTCMinutes() 會嘗試相應地更新 Date 物件中的日期資訊。例如,如果您將 secondsValue 設定為 100,則分鐘數將增加 1(minutesValue + 1),秒數將設定為 40。

示例

使用 setUTCMinutes()

js
const theBigDay = new Date();
theBigDay.setUTCMinutes(43);

規範

規範
ECMAScript® 2026 語言規範
# sec-date.prototype.setutcminutes

瀏覽器相容性

另見