【Ruby3.x】DateTime::iso8601()メソッドの使い方
iso8601メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
iso8601メソッドは、DateTimeオブジェクトが持つ日付と時刻の情報を、国際標準化機構（ISO）によって定められたISO 8601形式の文字列に変換して返すメソッドです。このメソッドは、異なるシステムやアプリケーション間で日付時刻データを一貫した方法で表現し、交換する際に非常に有効です。ISO 8601形式は、例えば「YYYY-MM-DDTHH:MM:SS+ZZ:ZZ」のように、日付、時刻、タイムゾーンオフセットを明確に区別して表記する国際的な標準形式です。
本メソッドには、秒の小数部の桁数を指定するオプションの引数fraction_digits（またはprecision）を渡すことができます。この引数に整数値を指定することで、秒以下の精度を制御し、必要に応じてミリ秒やマイクロ秒まで含めた時刻情報を出力できます。例えば、fraction_digitsに0を指定すると秒単位までの表示となり、3を指定するとミリ秒単位まで表示されます。
システムエンジニアリングにおいて、ログの記録、データベースへの保存、Web APIを通じたデータ連携など、標準化された形式で日付時刻を扱う場面は多岐にわたります。iso8601メソッドを利用することで、日付時刻の書式変換に関する開発者の手間を削減し、データの正確性と相互運用性を向上させることができます。
構文(syntax)
1DateTime.iso8601("2023-10-27T10:00:00+09:00")
引数(parameters)
str = '-4712-01-01T00:00:00+00:00', start = Date::GREGORIAN
- str: '-4712-01-01T00:00:00+00:00': ISO 8601形式の日付・時刻文字列を指定します。指定しない場合はデフォルト値が使用されます。
- start: Date::GREGORIAN: 基準となるカレンダーを指定します。指定しない場合はグレゴリオ暦が使用されます。
戻り値(return)
String
ISO 8601形式の文字列で日付と時刻を表します。