【Node.js24.x】Date::getSeconds()メソッドの使い方

getSecondsメソッドは、指定されたDateオブジェクトから、そのローカル時刻における秒数を取得するメソッドです。このメソッドは、0から59までの整数値として秒数を返します。日付や時刻を扱うプログラミングにおいて、特に秒単位の情報が必要な場合に非常に有用です。

具体的には、Node.js環境で現在時刻の秒数を取得したい場合、まずDateオブジェクトのインスタンスを作成し、そのインスタンスに対してgetSeconds()メソッドを呼び出します。例えば、const now = new Date(); const currentSeconds = now.getSeconds(); のように記述することで、変数currentSecondsには現在の時刻の秒数が格納されます。

戻り値は常に0（0秒）から59（59秒）の範囲内の整数値です。この機能は、時刻の表示形式をカスタマイズする際や、特定のイベントが何秒に発生したかを記録するロギング処理、あるいは時間間隔を計算するロジックの一部として活用できます。例えば、hh:mm:ssのようなフォーマットで時刻を表示する際に、getSeconds()で得られた値を使用することが一般的です。

このメソッドが返す秒数は、Dateオブジェクトが表現するローカルタイムゾーンに基づいています。もし、世界標準時であるUTC（協定世界時）での秒数が必要な場合は、代わりにgetUTCSeconds()メソッドを使用する必要があります。また、秒数にはミリ秒は含まれませんので、ミリ秒の情報を取得したい場合は、getMilliseconds()メソッドを利用してください。このメソッドは、時間データを正確に操作するための基本的なツールの一つとして、多くのアプリケーションで活用されています。

Copy
1const now = new Date();
2const seconds = now.getSeconds();
3console.log(seconds);

引数なし

引数はありません

number

Dateオブジェクトで表される日付の秒を表す数値を返します。この数値は0から59の範囲です。