【JavaScript ECMAScript】Temporal::Temporal.PlainDateTime.prototype.yearOfWeekインスタンスアクセサプロパティの使い方
Temporal.PlainDateTime.prototype.yearOfWeekインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainDateTime.prototype.yearOfWeekプロパティは、Temporal.PlainDateTimeオブジェクトのインスタンスが保持する、国際標準であるISO 8601規格に基づく「週の年」を数値で取得するための読み取り専用プロパティです。
このプロパティは、日付を週単位で扱う際に使用される、通常とは異なる年の概念を提供します。ISO 8601 週日付システムでは、1年の最初の週は「その年の最初の木曜日を含む週」と定義されるため、一般的なカレンダーの年とは異なる値を示す場合があります。
具体的には、ある年の1月1日を含む週が前年の最後の週とみなされる場合、このプロパティは前年の週の年を返します。反対に、12月31日を含む週が翌年の最初の週とみなされる場合は、翌年の週の年を返すことがあります。
Temporal.PlainDateTimeはタイムゾーン情報を持たない日付と時刻を表すオブジェクトですが、このyearOfWeekプロパティを利用することで、国際的な週の規則にのっとった正確な週単位の期間計算や表示が可能です。週単位でのデータ集計や、多国籍な環境でのスケジュール管理など、ISO 8601に準拠した週の概念が必要とされる場面で非常に有用です。
構文(syntax)
1const plainDateTime = new Temporal.PlainDateTime(2023, 1, 1, 12, 0, 0, 0, 0, 0); 2const weekBasedYear = plainDateTime.yearOfWeek;
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
このプロパティは、Temporal.PlainDateTime オブジェクトが表す日付の年における週番号を返します。週番号は1から53までの数値です。