【Ruby3.x】Time::iso8601()メソッドの使い方
iso8601メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
iso8601メソッドは、RubyのTimeオブジェクトが保持する日時情報を、国際標準であるISO 8601形式の文字列として出力するメソッドです。このメソッドは、Timeクラスのインスタンスに対して呼び出すことで利用できます。
ISO 8601形式は、「YYYY-MM-DDTHH:MM:SSZ」のように日付と時刻を統一的に表現する方法であり、異なるシステム間で日時データをやり取りする際に互換性を保つために広く使われています。例えば、ウェブAPIでのデータ交換、データベースへの日時データの保存、ログファイルの出力など、日時情報を標準的な形式で扱いたい場面で大変役立ちます。
このメソッドには、オプションとして小数秒の桁数を指定する引数を渡すことができます。引数を省略した場合、通常は秒までの精度で文字列が生成されますが、Timeオブジェクトの生成方法や環境によっては、より詳細なマイクロ秒まで含んだ形式になることもあります。引数に0を指定すると小数秒なしで出力され、3を指定するとミリ秒まで、6を指定するとマイクロ秒までといった形で、出力される小数秒の桁数を細かく制御することが可能です。
したがって、iso8601メソッドを使用することで、Timeオブジェクトを国際標準に準拠した形式で簡単に文字列化し、他のシステムとの連携やデータの標準化を円滑に進めることができます。
構文(syntax)
1Time.iso8601("2023-10-27T10:00:00+09:00")
引数(parameters)
string, limit_to_local_time = false
- string: ISO 8601形式で表された日時を表す文字列
- limit_to_local_time: trueを指定すると、UTCではなくローカルタイムとして解釈する真偽値 (デフォルト: false)
戻り値(return)
String
TimeオブジェクトをISO 8601形式の文字列に変換したものを返します。