Ruby DateTimeクラスの使い方

  • Ruby
  • クラス
最終更新日:

この記事のポイント

DateTimeクラスを学習する上で押さえておきたい重要なポイントを紹介します。これらの要素を理解することで、効率的に日付・時刻操作をマスターできます。

※なお、現在RubyではDateTimeクラスは非推奨となっており、Timeクラスを使うことが推奨されています。

  • 日付と時刻を統合して扱うシンプルなクラスの基本概念
  • 現在時刻の取得から書式設定まで対応する豊富なメソッド群
  • 実際の開発現場で活用できる実践的なコード記述テクニック

以下の内容を順番に学習することで、DateTimeクラスの全体像を把握できるでしょう。

目次

DateTimeクラスとは？

DateTimeクラスは、Rubyプログラミング言語で日付と時刻を統合して扱うためのクラスです。このクラスを使用することで、Webアプリケーションでのタイムスタンプ管理、ログファイルの時刻記録、スケジュール管理システムなど、さまざまな場面で正確な日時操作が可能になります。

なお、現在RubyではDateTimeクラスは非推奨となっており、Timeクラスを使うことが推奨されています。

【関連】
Rubyをもっと詳しく学ぶならpaizaラーニング

基本構文

DateTimeクラスを使用するには、まずrequireでライブラリを読み込む必要があります。

以下に基本的なコード例を示します。現在の日時を取得する場合はDateTime.nowメソッドを使用し、特定の日時を作成する場合はDateTime.newメソッドに年、月、日、時、分、秒の引数を渡します。これらの基本的な使い方をマスターすることで、より複雑な日時操作への応用が可能になります。

require 'date' # 現在の日時を取得 current_time = DateTime.now puts current_time







出力結果（例）
2025-09-07T07:39:48+00:00
※このページ内のコードの出力結果の一部で、実行した時刻により変動するものがあります。また、時刻はUTC形式で計算されるため、日本時間での計算結果と異なる場合があります

  
# 特定の日時を作成
require 'date'

specific_time = DateTime.new(2025, 12, 25, 9, 0, 0)
puts specific_time

  


  







出力結果
2025-12-25T09:00:00+00:00
実用例
DateTimeクラスの実用例では、実際の開発現場で頻繁に使用される日時操作のパターンを紹介します。これらのサンプルコードを通じて、基本構文で学んだ知識をより実践的な場面で活用する方法を習得できます。
各例では動物を使った親しみやすい出力結果を用いて、コードの動作を直感的に理解できるよう工夫しています。現在時刻の取得から複雑な日時計算まで、段階的に学習を進めることで、DateTimeクラスの全機能を効果的にマスターできるでしょう。
現在の日時を取得
現在の日時を取得する最も基本的な例です。Webアプリケーションでユーザーの行動ログを記録する際によく使用されます。

  
require 'date'

current_datetime = DateTime.now
puts "ネコが鳴いた時刻: #{current_datetime}"
formatted_time = current_datetime.strftime("%Y年%m月%d日 %H時%M分")
puts "書式設定後: #{formatted_time}"

  


  







出力結果（例）
ネコが鳴いた時刻: 2025-09-07T07:41:55+00:00
書式設定後: 2025年09月07日 07時41分
特定の日時を作成
指定した年月日時分秒でDateTimeオブジェクトを作成する例です。スケジュール管理やイベント登録システムで活用できます。

  
require 'date'

event_time = DateTime.new(2025, 7, 20, 10, 30, 0)
puts "イヌの散歩予定: #{event_time}"
puts "年: #{event_time.year}, 月: #{event_time.month}, 日: #{event_time.day}"

  


  







出力結果
イヌの散歩予定: 2025-07-20T10:30:00+00:00
年: 2025, 月: 7, 日: 20
日時の書式を変更
strftimeメソッドを使用して日時の表示形式をカスタマイズする例です。ユーザーインターフェースでの見やすい日時表示に役立ちます。

  
require 'date'

datetime = DateTime.new(2025, 4, 1, 15, 45, 30)
puts "ウサギの誕生日: #{datetime.strftime('%Y年%m月%d日')}"
puts "詳細時刻: #{datetime.strftime('%H時%M分%S秒')}"
puts "曜日込み: #{datetime.strftime('%Y/%m/%d (%a)')}"

  


  







出力結果
ウサギの誕生日: 2025年04月01日
詳細時刻: 15時45分30秒
曜日込み: 2025/04/01 (Tue)
日時の計算
DateTimeオブジェクトに対して加算や減算を行い日時の計算を実行する例です。期限管理や経過時間の計算で使用される処理です。

  
require 'date'

base_time = DateTime.new(2025, 6, 15, 12, 0, 0)
future_time = base_time + 7
past_time = base_time - 3
puts "パンダの餌やり基準日: #{base_time.strftime('%m/%d')}"
puts "7日後: #{future_time.strftime('%m/%d')}"
puts "3日前: #{past_time.strftime('%m/%d')}"

  


  







出力結果
パンダの餌やり基準日: 06/15
7日後: 06/22
3日前: 06/12
日時の比較
複数のDateTimeオブジェクト間で大小関係を比較する例です。条件分岐やソート処理で重要な役割を果たします。

  
require 'date'

time1 = DateTime.new(2025, 3, 10, 9, 0, 0)
time2 = DateTime.new(2025, 3, 15, 14, 30, 0)
puts "ライオンの診察: #{time1.strftime('%m/%d %H:%M')}"
puts "トラの診察: #{time2.strftime('%m/%d %H:%M')}"
puts "どちらが早い？: #{time1 < time2 ? 'ライオン' : 'トラ'}"

  


  







出力結果
ライオンの診察: 03/10 09:00
トラの診察: 03/15 14:30
どちらが早い？: ライオン
日時の要素を取得
DateTimeオブジェクトから年、月、日、時、分、秒の各要素を個別に取得する例です。データの分析や条件判定で各要素を参照する際に使用します。

  
require 'date'

datetime = DateTime.new(2025, 8, 25, 16, 20, 45)
puts "サルの観察記録: #{datetime}"
puts "観察年: #{datetime.year}年"
puts "観察月: #{datetime.month}月"
puts "観察時刻: #{datetime.hour}時#{datetime.min}分"

  


  







出力結果
サルの観察記録: 2025-08-25T16:20:45+00:00
観察年: 2025年
観察月: 8月
観察時刻: 16時20分
文字列から日時に変換
文字列形式の日時データをDateTimeオブジェクトに変換する例です。外部データの取り込みや入力値の処理で重要な処理となります。

  
require 'date'

date_string = "2025-09-12 08:30:00"
parsed_date = DateTime.parse(date_string)
puts "文字列: #{date_string}"
puts "キリンの朝食時刻: #{parsed_date}"
puts "変換後の曜日: #{parsed_date.strftime('%A')}"

  


  







出力結果
文字列: 2025-09-12 08:30:00
キリンの朝食時刻: 2025-09-12T08:30:00+00:00
変換後の曜日: Friday
まとめ
DateTimeクラスは、プログラミングにおける日付と時刻の管理を効率的に行うための強力なツールです。特に初学者の方でも段階的に学習することで、実用的なスキルを身につけることができるでしょう。
DateTimeクラスが使われる場面
    

  • Webアプリケーションでのユーザー行動ログ管理
    • 

  • スケジュール管理システムでのイベント日時処理
    • 

  • データベースのタイムスタンプ操作と検索機能
    • 

重要なポイント
    

  • 現在はRubyでは非推奨のクラスである
    • 

  • requireでライブラリ読み込みが必須
    • 

  • タイムゾーン対応で国際的なアプリ開発にも対応
    • 

これらの知識を活用することで、DateTimeクラスを使った効率的な日時処理が可能になり、より実践的なプログラム開発が行えるようになります。継続的な練習を通じて、さらなるスキル向上を目指していきましょう。
レベルを更に上げたい方はpaizaプログラミングスキルチェックへ





























  1. paizaラーニングトップ
  2. リファレンス
  3. Rubyのリファレンス記事一覧
  4. Ruby DateTimeクラスの使い方