【JavaScript ECMAScript】Date::Date.prototype.getTimeインスタンスメソッドの使い方
Date.prototype.getTime()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Date.prototype.getTime()メソッドは、JavaScriptのDateオブジェクトが保持する特定の日時を、協定世界時（UTC）の1970年1月1日0時0分0秒からどれだけミリ秒が経過したかを示す数値として取得するメソッドです。
このメソッドは、Dateオブジェクトのインスタンスに対して呼び出され、返される値は常に整数型のミリ秒数となります。例えば、現在時刻のDateオブジェクトを作成し、getTime()メソッドを呼び出すと、現在までの経過ミリ秒数が得られます。この数値は、一般的に「UNIXタイムスタンプ」に似た形式として知られており、タイムゾーンの影響を受けません。
getTime()メソッドの主な用途は、異なる日時間の比較や時間差の計算です。特定の日時を数値として一元的に扱うことができるため、例えばあるイベントの開始時刻と終了時刻の差を正確に算出したり、複数の日時データを時系列順に並べ替えたりする際に非常に有用です。データベースへの時刻の保存や、APIを介した日時情報の送受信など、システム開発の様々な場面で、日時情報を数値として標準的に扱うために広く利用されています。これにより、日時処理の正確性と効率性が向上します。
公式リファレンス: Date.prototype.getTime()
構文(syntax)
1const dateObj = new Date(); 2const timeInMilliseconds = dateObj.getTime();
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
このメソッドは、Dateオブジェクトが表す時刻を、UTC（協定世界時）の1970年1月1日午前0時0分0秒からの経過ミリ秒数で表した数値を返します。