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
實例所表示的時間為止,共經過的毫秒數。
嘗試一下
語法
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()
const theBigDay = new Date();
theBigDay.setHours(7);
規範
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.sethours |
瀏覽器相容性
BCD tables only load in the browser