setUTCMinutes() はDate インスタンスのメソッドで、協定世界時に基づき、指定された日時の「分」を設定します。

試してみましょう

const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");console.log(date1.getUTCMinutes());// 予想される結果: 15date1.setUTCMinutes(25);console.log(date1.getUTCMinutes());// 予想される結果: 25

構文

setUTCMinutes(minutesValue)setUTCMinutes(minutesValue, secondsValue)setUTCMinutes(minutesValue, secondsValue, msValue)

引数

minutesValue

「分」を表す 0 から 59 までの間の整数値。

secondsValue省略可

「秒」を表す 0 から 59 までの間の整数値。secondsValue 引数を指定した場合、minutesValue も指定しなければなりません。

msValue省略可

ミリ秒を表す 0 から 999 までの間の整数値。msValue 引数を指定した場合、minutesValue とsecondsValue も指定しなければなりません。

返値

その場でDate オブジェクトを変更し、新しいタイムスタンプを返します。引数がNaN （またはundefined など、NaN に変換されるその他の値）の場合、日付は無効な日時に設定され、NaN が返されます。

解説

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

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

例

setUTCMinutes() の使用

const theBigDay = new Date();theBigDay.setUTCMinutes(43);

仕様書

ブラウザーの互換性

関連情報

• Date.prototype.getUTCMinutes()
• Date.prototype.setMinutes()