【JavaScript ECMAScript】Date::Date.prototype.getDayインスタンスメソッドの使い方

Date.prototype.getDay()メソッドは、JavaScriptのDateオブジェクトに格納されている特定の日付について、そのローカルタイムにおける曜日を数値で取得するメソッドです。

このメソッドは、new Date()コンストラクタで作成されたDateオブジェクトのインスタンスに対して呼び出され、現在の日付や指定された日付の曜日情報を得たい場合に利用されます。戻り値は0から6までの整数値で、それぞれ以下の曜日を表します。日曜日が0、月曜日が1、火曜日が2、水曜日が3、木曜日が4、金曜日が5、土曜日が6です。例えば、本日が火曜日である場合、new Date().getDay()と実行すると、2が返されます。これにより、開発者は数値を用いて、特定の曜日に対する処理をプログラム内で簡単に実装できるようになります。

getDay()メソッドが返す曜日は、そのDateオブジェクトが表現する時刻を、スクリプトが実行されているシステムのローカルタイムゾーンで解釈した結果に基づいています。そのため、異なるタイムゾーンのユーザーに対してサービスを提供するアプリケーションを開発する際には、日付や時刻の扱いに注意を払う必要があります。

システムエンジニアが開発するアプリケーションでは、例えば、カレンダーアプリケーションで各日付の曜日を表示したり、毎週特定の曜日に実行されるバッチ処理の条件判定を行ったり、ユーザーが選択した日付が週末かどうかを判定したりするなど、多岐にわたる場面でこのメソッドが活用されます。日付から直接曜日を数値として取得できるため、複雑な計算をせずに簡潔に曜日関連のロジックを記述できる点が大きなメリットです。

Copy
1const dateObj = new Date();
2const day = dateObj.getDay();

引数なし

引数はありません

Number

このメソッドは、Dateオブジェクトで表される日付の曜日を返します。戻り値は0（日曜日）から6（土曜日）までの整数です。