このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
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月.
setUTCHours() はDate インスタンスのメソッドで、協定世界時に基づき、この日時の時、分、秒、ミリ秒を変更します。
試してみましょう
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());// 予想される結果: 2event.setUTCHours(23);console.log(event.toUTCString());// 予想される結果: "Wed, 20 Aug 1975 23:15:30 GMT"構文
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 （またはundefined など、NaN に変換されるその他の値）の場合、日付は無効な日時に設定され、NaN が返されます。
解説
minutesValue,secondsValue およびmsValue 引数を指定しない場合、getUTCMinutes() とgetUTCSeconds()、getUTCMilliseconds() メソッドから返される値が使われます。
指定した値が期待される日付の範囲外の場合、それに応じてsetUTCHours() がDate オブジェクトの日付情報の更新を試みます。例えば、secondsValue に 100 を指定した場合、分に 1 が加算 (minutesValue + 1) され、秒が 40 になります。
例
setUTCHours() の使用
const theBigDay = new Date();theBigDay.setUTCHours(8);仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setutchours |