【Ruby3.x】Date::cwyear()メソッドの使い方

cwyearメソッドは、レシーバーとなるDateオブジェクトが属するISO 8601準拠の週番号付けシステムにおける暦年（週ベースの年）を数値で返すメソッドです。ISO 8601は国際的な日付と時刻の表記に関する規格であり、この規格では週の開始を月曜日とし、年の最初の週はその年の最初の木曜日を含む週と定義されています。

この週ベースの年は、通常のグレゴリオ暦における年とは異なる場合があります。具体的には、1月1日を含む週が前の年の最後の週に分類される場合や、逆に12月末の日付を含む週が翌年の最初の週に分類される場合です。例えば、もし特定の日付の1月1日が、ISO 8601の定義に基づいて前の年の最後の週に属すると判断される場合、cwyearメソッドはその前の年の値を返します。

このように、一般的な暦年とは異なる基準で年を扱うため、週単位での正確なデータ集計や、ISO 8601規格に準拠した週ベースの年情報を必要とするシステムで特に有用です。開発者は、このメソッドを用いて、国際規格に基づいた週の区分に対応する年を正確に取得することができます。

Copy
1require 'date'
2
3date_instance = Date.new(2023, 1, 1)
4date_instance.cwyear

引数なし

引数はありません

Integer

その年の週番号を返します。