【Ruby3.x】Date::strptime()メソッドの使い方
strptimeメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
strptimeメソッドは、文字列を日付オブジェクトに変換するメソッドです。このメソッドは、指定された書式に従って日付と時刻を表す文字列を解析し、RubyのDateクラスのインスタンス、つまり日付オブジェクトを生成します。
基本的な使い方は、Date.strptime(文字列, フォーマット文字列) の形式です。最初の引数である「文字列」は、解析したい日付情報を含む文字列です。次の「フォーマット文字列」は、その日付文字列がどのような形式で記述されているかを指定するためのものです。例えば、「2023-01-15」という日付文字列を解析するには、「%Y-%m-%d」というフォーマット文字列を指定します。ここで「%Y」は4桁の年、「%m」は2桁の月、「%d」は2桁の日を表す書式指定子です。
strptimeメソッドは、ログファイルや外部システムから取得したデータなど、様々な形式で記述された日付文字列をプログラムで処理可能なDateオブジェクトに変換する際に非常に有用です。これにより、日付の比較や計算といった操作を容易に行うことができます。
もし、指定したフォーマット文字列と実際の入力文字列の形式が一致しない場合、このメソッドはArgumentErrorを発生させます。そのため、正確なフォーマット指定が重要となります。このメソッドを適切に活用することで、日付データの柔軟なハンドリングとエラーの早期発見が可能になります。
構文(syntax)
1require 'date' 2 3Date.strptime("2023-10-26", "%Y-%m-%d")
引数(parameters)
string, format, start_date = Date::ITALY
- string: 解析する日付を表す文字列
- format: string: 解析に使用する日付フォーマットの書式文字列。例: "%Y-%m-%d"
- start_date: Date = Date::ITALY: 曜日計算の基準となる日付。デフォルトはイタリア方式 (月曜日を週の始まりとする)
戻り値(return)
Date
指定されたフォーマット文字列とタイムゾーンを使用して、日付と時刻を表すDateオブジェクトを生成して返します。