【JavaScript ECMAScript】Date::Date.prototype.setTimeインスタンスメソッドの使い方
Date.prototype.setTime()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Date.prototype.setTime()メソッドは、Dateオブジェクトが保持する時刻情報を、指定されたミリ秒数で更新するメソッドです。
このメソッドは、既存のDateインスタンスの時刻値を変更するために使用されます。引数には、UTC（協定世界時）の1970年1月1日0時0分0秒（Unixエポックと呼ばれる基準点）から現在までの経過ミリ秒数を数値で指定します。例えば、特定のタイムスタンプを持つDateオブジェクトを新しく生成するのではなく、すでに存在するDateオブジェクトの時刻を別の時点に再設定したい場合に役立ちます。
このメソッドが呼び出されると、Dateオブジェクトの内部的な時刻が指定されたミリ秒数に基づいて更新され、引数として渡した新しい時刻値が戻り値として返されます。これにより、プログラムの実行中に動的にDateオブジェクトの時刻を操作し、表示や計算に利用することができます。新しいDateオブジェクトを繰り返し作成することなく、既存のオブジェクトの状態を変更できるため、効率的な時刻管理が可能です。
公式リファレンス: Date.prototype.setTime()
構文(syntax)
1const dateObject = new Date(); 2dateObject.setTime(milliseconds);
引数(parameters)
timeValue
- timeValue: number: UTC（協定世界時）で1970年1月1日午前0時0分0秒からの経過ミリ秒数を表す数値
戻り値(return)
Number
Date.prototype.setTime() メソッドは、Dateオブジェクトの時刻をミリ秒単位で設定し、その設定された時刻を表す数値を返します。