【Ruby3.x】Date::valid_commercial?()メソッドの使い方
valid_commercial?メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
valid_commercial?メソッドは、指定された年、週番号、曜日が有効な日付を表すかどうかを判定するメソッドです。
このメソッドは、国際標準化機構が定めたISO 8601規格に基づく商用週日付（暦週日付）の妥当性をチェックするために利用されます。引数として、年を表すcwyear、その年の週番号を表すcweek、そして週の曜日を表すcdayの3つの整数を受け取ります。cweekは通常1から53の範囲で指定され、cdayは月曜日を1、日曜日を7として1から7の範囲で指定します。
指定されたこれらの引数の組み合わせが、実際に存在する日付を構成する場合にtrueを返します。一方で、例えば存在しない週番号や曜日の値を指定したり、その年における週の範囲を超えた週番号を指定したりした場合にはfalseを返します。この機能は、ユーザーからの日付入力の検証や、週単位でのスケジュール管理、レポート作成など、日付データを厳密に扱う必要があるシステム開発において、データの整合性を保つ上で非常に有用です。
構文(syntax)
1Date.valid_commercial?(2023, 10, 3)
引数(parameters)
cwyear, cweek, cwday
- cwyear: 年を指定する整数 (YYYY形式)
- cweek: 週を指定する整数 (1-53)
- cwday: 曜日を指定する整数 (1-7、月曜日を1とする)
戻り値(return)
Boolean
指定された日付が、グレゴリオ暦における商業的な有効日（西暦1年1月1日以降）である場合にtrueを、そうでない場合にfalseを返します。