【Ruby3.x】Date::cwday()メソッドの使い方
cwdayメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
cwdayメソッドは、RubyのDateクラスに属し、Dateオブジェクトが表す日付の曜日を数値で取得するメソッドです。
このメソッドは、ISO 8601国際規格に準拠した週番号付けシステムに基づいて曜日を返します。ISO 8601の定義では、月曜日を1、火曜日を2、水曜日を3、木曜日を4、金曜日を5、土曜日を6、そして日曜日を7として扱います。これは、多くのプログラミング言語やカレンダーで一般的な、日曜日を1とする方式とは異なる点に注意が必要です。
cwdayメソッドを使用することで、特定の日付が週のどの位置にあるかを、国際的な基準に沿って判断できます。例えば、ある日付が月曜日であれば1を、水曜日であれば3を、日曜日であれば7を返します。
この機能は、週の始まりを月曜日とするビジネスロジックや、国際的な日付データを取り扱うシステムを開発する際に特に役立ちます。Dateオブジェクトからcwdayメソッドを呼び出すだけで、簡単に該当する日付のISO 8601形式の曜日番号を取得でき、柔軟な日付計算や表示処理に活用できます。返される値は常に1から7の範囲の整数です。
構文(syntax)
1require 'date' 2 3Date.new(2023, 11, 20).cwday
引数(parameters)
引数なし
引数はありません
戻り値(return)
Integer
このメソッドは、Dateオブジェクトが表す日付の週番号（月曜日を1、日曜日を7とする）を整数で返します。