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

cweekメソッドは、Dateオブジェクトが表す日付がその年の何週目にあたるかを、ISO 8601国際規格に基づいて取得するメソッドです。ISO 8601は、日付と時刻の表記に関する国際的な規格であり、週の定義もその一部です。この規格では、週の開始日は月曜日と定められており、その年の最初の週（第1週）は、その年の1月4日を含む週、またはその年の最初の木曜日を含む週と定義されています。

この定義に基づくと、年の始まりの数日間が前の年の最後の週として扱われたり、逆に前の年の終わりの数日間が新しい年の最初の週として扱われたりする場合があります。例えば、1月1日が金曜日だった場合、その週の月曜日（前年の12月28日）から日曜日（1月3日）までは前年の最後の週と見なされ、その年の第1週は1月4日の月曜日から始まります。cweekメソッドは、このように国際規格に準拠した厳密な週番号を取得したい場合に利用されます。ビジネスシステムにおける週単位のレポート作成や、国際的なプロジェクトでの日付管理など、正確な週番号が必要とされる場面で非常に有用です。

Copy
1require 'date'
2
3date_object = Date.new(2023, 1, 1)
4date_object.cweek # => 1

引数なし

引数はありません

Integer

このメソッドは、Dateオブジェクトが属する年の、ISO 8601規格に基づいた週番号を整数で返します。