Date.prototype.setUTCHours()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
Date 實例的 setUTCHours() 方法會根據世界協調時間變更此日期的時、分、秒及/或毫秒。
嘗試一下
const event = new Date("August 19, 1975 23:15:30 GMT-3:00"); console.log(event.toUTCString()); // 預期輸出:「Wed, 20 Aug 1975 02:15:30 GMT」 console.log(event.getUTCHours()); // 預期輸出:2 event.setUTCHours(23); console.log(event.toUTCString()); // 預期輸出:「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,則必須同時指定minutesValue和secondsValue。
回傳值
就地更改 Date 物件,並回傳其新的時間戳。若參數為 NaN(或其他會被強制轉型為 NaN 的值,例如 undefined),則日期會被設為無效日期,並回傳 NaN。
描述
若你沒有指定 minutesValue、secondsValue 和 msValue 參數,將會使用 getUTCMinutes()、getUTCSeconds() 和 getUTCMilliseconds() 方法回傳的值。
若你指定的參數超出預期範圍,setUTCHours() 會相應地嘗試更新 Date 物件中的日期訊息。例如,若你為 secondsValue 指定 100,則分鐘數會增加 1(minutesValue + 1),而秒數則會使用 40。
範例
>使用 setUTCHours()
js
const theBigDay = new Date(); theBigDay.setUTCHours(8); 規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-date.prototype.setutchours> |