【JavaScript ECMAScript】Date::Date.prototype.setMinutesインスタンスメソッドの使い方

Date.prototype.setMinutes()メソッドは、JavaScriptのDateオブジェクトが持つ時刻情報の「分」およびオプションで「秒」と「ミリ秒」を設定するメソッドです。このメソッドを使用すると、指定されたDateオブジェクトの時刻の一部を更新することができます。

第一引数であるminutesValueには、設定したい分の値を数値で指定します。通常は0から59の範囲の値を指定しますが、この範囲を超えた値（例えば60や-1など）を指定した場合でも、自動的に時間や日付が調整されます。例えば、60分を指定すると1時間として繰り上がります。

第二引数であるsecondsValueはオプションで、設定したい秒の値を0から59の範囲で指定します。この引数を省略した場合、秒は0に設定されます。この値も範囲を超えると分が自動的に調整されます。

第三引数であるmsValueもオプションで、設定したいミリ秒の値を0から999の範囲で指定します。この引数を省略した場合、ミリ秒は0に設定されます。この値も範囲を超えると秒が自動的に調整されます。

いずれの引数も指定せずにこのメソッドを呼び出した場合、対象のDateオブジェクトの分は変更されず、秒とミリ秒のみが0に設定されます。

このメソッドは、呼び出されたDateオブジェクト自体を直接変更します。そして、変更後のDateオブジェクトが示す、1970年1月1日 00:00:00 UTC（協定世界時）からの経過ミリ秒数を数値として返します。特定の日時の分、秒、ミリ秒をプログラムから細かく設定したい場合に利用されます。

Copy
1const date = new Date();
2date.setMinutes(15);

minutesValue, secondsValue, msValue

• minutesValue: number: 設定する分の値を表す数値
• secondsValue: number (optional): 設定する秒の値を表す数値。省略された場合は0が使用されます。
• msValue: number (optional): 設定するミリ秒の値を表す数値。省略された場合は0が使用されます。

number

このメソッドは、Dateオブジェクトで設定された、UTC（協定世界時）でのミリ秒単位の表現である数値（number）を返します。