Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Ruby3.x】DateTime::to_s()メソッドの使い方

to_sメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

to_sメソッドは、RubyのDateTimeクラスに属し、DateTimeオブジェクトが保持する日付と時刻の情報を、人間が読みやすい標準的な文字列形式に変換して返すメソッドです。

このメソッドは、DateTimeオブジェクトが持つ年、月、日、時、分、秒、そしてタイムゾーンオフセットといった全ての要素を一つの文字列として表現します。具体的には、ISO 8601形式に準拠したYYYY-MM-DDTHH:MM:SS+HH:MM(例: 2023-10-27T10:30:00+09:00)のような書式で出力されます。この書式は国際的に広く利用されており、日付と時刻の情報が明確に伝わるため、異なるシステム間でのデータ交換や、国や地域に依存しない表示に適しています。

DateTimeオブジェクトをそのまま出力した場合に見られる内部的な情報ではなく、その日付と時刻の意味をすぐに理解できる形に整形されるため、プログラムのデバッグ時やログ出力、あるいはユーザーインターフェースでの情報表示など、様々な場面で非常に役立ちます。開発者がDateTimeオブジェクトの内容を手軽に確認したいときや、特定の標準形式で日付と時刻の情報を他のシステムに渡したいときに利用すると便利です。

構文(syntax)

1require 'date'
2
3dt = DateTime.new(2023, 1, 1, 12, 0, 0)
4puts dt.to_s

引数(parameters)

引数なし

引数はありません

戻り値(return)

String

このメソッドは、DateTimeオブジェクトを人間が読みやすい形式の文字列に変換して返します。

関連コンテンツ