Date.prototype.setHours()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

setHours() 方法基於本地時區設置指定日期的小時，並回傳自 1970 年 1 月 1 日 00:00:00 UTC 起至更新的 Date 實例所表示的時間為止，共經過的毫秒數。

嘗試一下

語法

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

參數

hoursValue

表示小時，理想上為介於 0 至 23 之間的整數。若傳入的值大於 23，溢出時數會增加日期時間。

minutesValue

可選的。表示分鐘，理想上為介於 0 至 59 之間的整數。若傳入的值大於 59，溢出分鐘數會增加日期時間。

secondsValue

可選的。表示秒，理想上為介於 0 至 59 之間的整數。若傳入的值大於 59，溢出秒數會增加日期時間。若給定 secondsValue，則必須同時給定 minutesValue 參數值。

msValue

可選的。表示毫秒，理想上為介於 0 至 999 之間的數。若傳入的值大於 999，溢出毫秒數會增加日期時間。若給定 msValue 的值，則必須同時給定 minutesValue 與 secondsValue 參數值。

返回值

1970 年 1 月 1 日 00:00:00 UTC 與更新日期之間的毫秒差異數。

描述

如果沒有指明 minutesValue、secondsValue 與 msValue 參數值，則會使用 getMinutes()、getSeconds()、getMilliseconds() 方法回傳的值。

如果給定的參數值超出預期範圍，setHours() 會相對應地更新 Date 物件的日期資訊。例如，secondsValue 傳入 100 ，分鐘數將增加 1（minutesValue + 1）、其餘的 40 則計入秒數。

範例

使用 setHours()

js
const theBigDay = new Date();
theBigDay.setHours(7);

規範

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.sethours

瀏覽器相容性

BCD tables only load in the browser

參見