【Node.js24.x】Date::getTime()メソッドの使い方
getTimeメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
getTimeメソッドは、Node.jsにおいて、Dateオブジェクトが保持する日付と時刻情報を、協定世界時(UTC)の1970年1月1日00:00:00からの経過ミリ秒数として取得するメソッドです。このメソッドは、JavaScriptの標準組み込みオブジェクトであるDateクラスのインスタンスに対して呼び出されます。
戻り値は常に数値(Number型)であり、対象のDateオブジェクトが表す時刻が、紀元(エポック)からのミリ秒数を正確に示します。このミリ秒数の値は、タイムスタンプとして広く利用されており、複数の時刻データを比較したり、時間的な順序を判定したりする際に非常に役立ちます。例えば、ある処理が開始した時刻と終了した時刻の差を計算して、処理時間を計測するような場面で活用できます。
また、得られたミリ秒数は、データベースに時間を保存したり、異なるシステム間で時刻情報をやり取りしたりする際の標準的な形式としても使われます。この数値を利用すれば、特定の時点を正確に表現し、その数値から再び新しいDateオブジェクトを生成することも可能です。時間の比較や計算を確実かつ効率的に行うために、getTimeメソッドは不可欠な機能を提供します。
構文(syntax)
1const dateObject = new Date(); 2const milliseconds = dateObject.getTime(); 3console.log(milliseconds);
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
Dateオブジェクトが表す時刻を、協定世界時(UTC)の1970年1月1日午前0時0分0秒からの経過ミリ秒数で返します。