MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Date.prototype.setHours()

setHours() メソッドは、地方時に基づき、指定された日付の「時」を設定し、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された Date インスタンスが表す時刻までの間のミリ秒単位の数値を返します。

構文

dateObj.setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

JavaScript 1.3 以前

dateObj.setHours(hoursValue)

引数

hoursValue
「時」を表す 0 から 23 までの間の整数値。
minutesValue
任意。「分」を表す 0 から 59 までの間の整数値。
secondsValue
任意。「秒」を表す 0 から 59 までの間の整数値。secondsValue 引数を指定した場合、minutesValue も指定しなければなりません。
msValue
任意。ミリ秒を表す 0 から 999 までの間の整数値。msValue 引数を指定した場合、minutesValuesecondsValue も指定しなければなりません。

戻り値

協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。

説明

minutesValue, secondsValue および msValue 引数を指定しない場合、getMinutes()getSeconds()getMilliseconds() メソッドから返される値が使われます。

指定した値が期待される日付の範囲外の場合、それに応じて setHours() が他の引数と Date オブジェクトの日付情報の更新を試みます。例えば、secondsValue に 100 を指定した場合、分に 1 加算 (minutesValue + 1) され、秒が 40 になります。

setHours() を使う

var theBigDay = new Date();
theBigDay.setHours(7);

仕様

仕様書 策定状況 備考
ECMAScript 1st Edition (ECMA-262) 標準 初期定義。JavaScript 1.0 で実装。
ECMAScript 5.1 (ECMA-262)
Date.prototype.setHours の定義
標準  
ECMAScript 2015 (6th Edition, ECMA-262)
Date.prototype.setHours の定義
標準  
ECMAScript 2017 Draft (ECMA-262)
Date.prototype.setHours の定義
ドラフト  

ブラウザの実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) (有) (有) (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: Marsf, shide55
 最終更新者: Marsf,