【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.dayOfWeekインスタンスアクセサプロパティの使い方

Temporal.ZonedDateTime.prototype.dayOfWeekプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する特定の日時における曜日を数値で取得するためのプロパティです。このプロパティにアクセスすると、そのZonedDateTimeインスタンスが示す日時が、週の何日目にあたるかを1から7までの整数値で返します。

具体的には、ISO 8601標準に基づいて、月曜日が1、火曜日が2、水曜日が3、木曜日が4、金曜日が5、土曜日が6、日曜日が7という数値が割り当てられています。このプロパティは、タイムゾーン情報を持つ日時データから曜日をプログラムで判定したり、特定の曜日に基づいた処理を実装したりする際に非常に役立ちます。例えば、特定の曜日にのみ実行されるバッチ処理の条件分岐や、週ごとのデータを集計するレポート作成など、日付と時刻の操作を伴う多様なシステム開発において、曜日情報を正確かつ効率的に扱うための重要な機能を提供します。日時データを扱うプログラミングにおいて、曜日情報を数値で統一的に扱うことは、複雑な日付計算をシンプルにし、コードの可読性と保守性を高める上で非常に有効な手段です。

Copy
1// Temporal.ZonedDateTime オブジェクトのインスタンスを作成します。
2const zonedDateTime = new Temporal.ZonedDateTime(
3  Temporal.Instant.from('2023-10-27T10:00:00Z'), // 特定のUTC時刻
4  'Asia/Tokyo' // タイムゾーン
5);
6
7// zonedDateTime インスタンスの dayOfWeek プロパティにアクセスし、
8// 曜日を数値 (1=月曜日, 2=火曜日, ..., 7=日曜日) で取得します。
9const dayOfWeekNumber = zonedDateTime.dayOfWeek;

引数なし

引数はありません

number

このプロパティは、その日付の曜日を表す数値を返します。曜日は1（月曜日）から7（日曜日）までの整数で表されます。