【Node.js24.x】Date::setMinutes()メソッドの使い方
setMinutesメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
setMinutesメソッドは、Dateオブジェクトの「分」の値を設定するために使用されるメソッドです。このメソッドは、指定されたDateインスタンスの分を新しい値に変更します。オプションとして、秒とミリ秒も同時に設定することが可能です。
引数としては、設定したい分を表すminutesValueが必須です。この値は0から59の範囲で指定するのが一般的ですが、それ以外の値を指定することもできます。たとえば、60と指定すると、時間は1時間進み、分は0に設定されます。オプションの引数として、secondsValue（秒）とmsValue（ミリ秒）を受け取ります。これらの引数を指定しない場合、Dateオブジェクトの現在の秒とミリ秒の値がそのまま保持されます。
setMinutesメソッドを実行すると、対象のDateオブジェクトが更新され、新しい日付と時刻が反映されます。このメソッドは、更新されたDateオブジェクトの1970年1月1日0時0分0秒（UTC）からのミリ秒数を返します。このメソッドを使用することで、日付オブジェクトの分を柔軟に操作し、特定の時刻に調整したり、計算結果を反映させたりすることが可能になります。他の日付要素（年、月、日、時）は、分、秒、ミリ秒の変更によって時間繰り上がりが生じない限り、変更されることはありません。これにより、特定の部分だけを効率的に変更できるため、日付や時刻を扱うプログラミングにおいて非常に有用です。
構文(syntax)
const dateObj = new Date();
dateObj.setMinutes(minutesValue);
引数(parameters)
minutesValue, secondsValue, msValue
- minutesValue: number: 設定する分の値を指定します。
- secondsValue: number = 0: 設定する秒の値を指定します。省略された場合は0になります。
- msValue: number = 0: 設定するミリ秒の値を指定します。省略された場合は0になります。
戻り値(return)
number
Dateオブジェクトの setMinutes() メソッドは、引数として渡された値（ミリ秒単位）でgetMinutes() メソッドの戻り値を設定した後の、Dateオブジェクトのタイムスタンプ（1970年1月1日午前0時0分0秒 UTCからの経過ミリ秒数）を返します。