Date.prototype.setUTCHours()

Baseline 已廣泛支援

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

setUTCHours() 方法用於更改 Date 例項的日期的小時、分鐘、秒和/或毫秒,該更改根據通用時間進行。

試一試

const event = new Date("August 19, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 02:15:30 GMT"

console.log(event.getUTCHours());
// Expected output: 2

event.setUTCHours(23);

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 23:15:30 GMT"

語法

js
setUTCHours(hoursValue)
setUTCHours(hoursValue, minutesValue)
setUTCHours(hoursValue, minutesValue, secondsValue)
setUTCHours(hoursValue, minutesValue, secondsValue, msValue)

引數

hoursValue

一個介於 0 到 23 之間的整數,代表小時。

minutesValue 可選

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

secondsValue 可選

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

msValue 可選

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

返回值

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

描述

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

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

示例

使用 setUTCHours()

js
const theBigDay = new Date();
theBigDay.setUTCHours(8);

規範

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

瀏覽器相容性

另見