【Ruby3.x】Date::parse()メソッドの使い方
parseメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
parseメソッドは、日付を表す文字列を解析し、Dateオブジェクトを生成するクラスメソッドです。このメソッドは、プログラム内で文字列として扱われている日付データを、RubyのDateクラスが提供する機能を利用して操作できるよう、Dateオブジェクトに変換する目的で使用されます。
主な機能として、第一引数に解析したい日付の文字列を指定することで、その文字列から日付情報を読み取ります。例えば、「2023-10-27」や「October 27, 2023」といった様々な形式の日付文字列に対応しており、柔軟な日付解析が可能です。
オプションとして、第二引数compを指定することができます。このcomp引数は、指定された日付文字列が西暦情報を含まない場合に、どの世紀の年として解釈するかを制御する際に利用されます。省略した場合は、適切な世紀が自動的に推測されますが、明示的に指定することで意図しない日付の解釈を防ぐことができます。
解析に成功すると、指定された日付を表すDateオブジェクトが返されます。これにより、そのDateオブジェクトに対して、曜日や年の取得、日付の計算といったDateクラスが持つメソッドを適用できるようになります。もし、与えられた文字列が日付として認識できない不適切な形式であった場合、ArgumentErrorなどの例外が発生することがありますので、入力文字列の形式には注意が必要です。
このように、parseメソッドは、テキストデータから日付情報を抽出し、プログラムで扱いやすいDateオブジェクトに変換するための、非常に便利で重要な機能を提供しています。
構文(syntax)
1require 'date' 2 3Date.parse("2023-10-27")
引数(parameters)
date, comp = false
- date: 日付を表す文字列、または
Dateオブジェクト - comp = false: 比較モードを有効にするかどうかを指定する真偽値 (デフォルトは
false)
戻り値(return)
Date
指定された文字列を解析して、Dateオブジェクトを生成します。