【Ruby3.x】Date::_strptime()メソッドの使い方
_strptimeメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
_strptimeメソッドは、文字列として表現された日付や時刻の情報を、指定された書式（フォーマット）に従って解析し、その構成要素をハッシュ形式で取得するメソッドです。RubyのDateクラスに属しており、プログラムが外部から受け取る多様な形式の日付や時刻データを、年、月、日、時、分、秒といった個別の要素に分解し、扱いやすい形で取り出すために利用されます。
このメソッドは、解析したい日付/時刻の文字列と、その文字列がどのような書式で記述されているかを示すフォーマット文字列の二つを引数として受け取ります。例えば、「2023-10-26 15:30:00」という文字列に対して「%Y-%m-%d %H:%M:%S」というフォーマットを指定することで、正確な解析が可能です。
メソッドの実行結果としては、解析された日付や時刻の各要素が、キーと値のペアで構成されるハッシュとして返されます。具体的には、{"year"=>2023, "mon"=>10, "mday"=>26, "hour"=>15, "min"=>30, "sec"=>0}のように、年、月、日、時、分、秒などの情報が辞書形式のデータとして得られます。
_strptimeメソッドは、Date.strptimeやDateTime.strptimeといった、より上位レベルで日付/時刻オブジェクトを生成するメソッドが内部的に利用する基盤となる機能です。システムが様々なソースから日付データを効率的かつ正確に処理するための重要な役割を担っています。
構文(syntax)
1Date._strptime(string, format_string)
引数(parameters)
str, fmt
- str: 変換する日付/時刻を表す文字列
- fmt: str を解析するためのフォーマット文字列
戻り値(return)
Hash
指定されたフォーマット文字列に基づいて、日付と時刻の各要素を解析した結果を格納したハッシュを返します。