【Ruby3.x】Date::iso8601()メソッドの使い方
iso8601メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
iso8601メソッドは、国際標準規格であるISO 8601形式の日付文字列を解析し、それに対応するDateオブジェクトを新しく作成するメソッドです。ISO 8601は日付と時刻の表記に関する国際的なルールを定めており、このメソッドは、外部システムなどから受け取った標準化された日付文字列を、RubyのDateオブジェクトとしてプログラム内で扱える形に変換します。
第一引数には解析対象となるISO 8601形式の日付文字列を指定します。第二引数には任意でグレゴリオ暦の開始日を指定できますが、通常はデフォルト値が適用されるため、特に意識する必要はありません。
このメソッドは、指定された文字列から適切に生成されたDateオブジェクトを返します。もし与えられた文字列がISO 8601形式として認識できない場合や、日付として無効な内容である場合は、ArgumentErrorが発生しますので、入力値が正しい形式であることを確認することが重要です。
外部システムとのデータ連携や、ログファイルの解析など、標準的な形式で日付を扱う必要がある場面で非常に有用です。このメソッドを利用することで、日付データの取り扱いを一貫させ、異なる環境間での互換性を保ちながら、システムの信頼性を向上させることができます。
構文(syntax)
1require 'date' 2 3date_object = Date.iso8601("2023-10-27")
引数(parameters)
str = '-4712-01-01', sgid = Date::ITALY
- str = '-4712-01-01': ISO 8601形式の文字列で日付を指定します。デフォルトは紀元前4712年1月1日です。
- sgid = Date::ITALY: Gregorian (グレゴリオ暦) または Julian (ユリウス暦) のどちらの暦法を使用するかを指定します。デフォルトはGregorian暦のItalyでの基準です。
戻り値(return)
String
ISO 8601 形式の文字列を返します。