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 July 2015.

setUTCHours() 方法根據世界時設置指定日期的小時,並回傳自 1970 年 1 月 1 日 00:00:00 UTC 至更新的 Date 實例所表示的時間為止,經過的毫秒數。

嘗試一下

語法

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 參數值。

返回值

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

描述

如果沒有指明 minutesValuesecondsValuemsValue 參數值,則會使用 getUTCMinutes()getUTCSeconds()getUTCMilliseconds() 方法回傳的值。

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

範例

使用 setUTCHours()

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

規範

Specification
ECMAScript Language Specification
# sec-date.prototype.setutchours

瀏覽器相容性

BCD tables only load in the browser

參見