【JavaScript ECMAScript】Temporal::Temporal.PlainDateTime.prototype.dayOfWeekインスタンスアクセサプロパティの使い方
Temporal.PlainDateTime.prototype.dayOfWeekインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Temporal.PlainDateTime.prototype.dayOfWeekプロパティは、Temporal.PlainDateTimeオブジェクトが保持する日付の曜日を数値で表すプロパティです。
このプロパティにアクセスすると、PlainDateTimeインスタンスが表す日付の曜日が数値として取得できます。戻り値は1から7までの整数値で、国際標準であるISO 8601の週番号付け規則に従います。具体的には、月曜日が1、火曜日が2、水曜日が3、木曜日が4、金曜日が5、土曜日が6、そして日曜日が7として定義されます。
このプロパティは、特定の日が何曜日であるかをプログラムで判断する際や、週ごとのスケジュール管理、レポート作成などで曜日を基準にした処理を行う場合に非常に便利です。開発者は、複雑な日付計算ロジックを実装せずとも、直感的に曜日情報を扱えるようになります。
PlainDateTimeオブジェクトはタイムゾーン情報を持たないため、dayOfWeekプロパティが返す曜日もタイムゾーンの影響を受けません。JavaScriptの既存のDateオブジェクトの曜日表現とは異なり、ISO 8601に準拠した一貫性のある数値表現を提供するため、国際的なアプリケーション開発においても信頼性の高い日付処理を実現できます。
構文(syntax)
1const plainDateTime = new Temporal.PlainDateTime(2023, 1, 15); 2const dayOfWeek = plainDateTime.dayOfWeek;
引数(parameters)
引数なし
引数はありません
戻り値(return)
Number
このプロパティは、Temporal.PlainDateTimeオブジェクトが表す日付の曜日を表す数値を返します。曜日は日曜日が1、月曜日が2、...、土曜日が7として表現されます。