Time 類在 Ruby 中用於表示日期和時間。它是基於作業系統提供的系統日期和時間之上。該類可能無法表示 1970 年之前或者 2038 年之後的日期。
本教程將讓您熟悉日期和時間的所有重要的概念。
創建當前的日期和時間下面是獲取當前的日期和時間的簡單實例：
實例#!/usr/bin/ruby -w
# -*- coding: UTF-8 -*-
time1 = Time.new
puts "當前時間 : " + time1.inspect
# Time.now 功能相同
time2 = Time.now
puts "當前時間 : " + time2.inspect
運行實例 »
這將產生以下結果：
Current Time : Mon Jun 02 12:02:39 -0700 2008
Current Time : Mon Jun 02 12:02:39 -0700 2008
我們可以使用 Time 對象來獲取各種日期和時間的組件。請看下面的實例：
#!/usr/bin/ruby -w# -*- coding: UTF-8 -*-
time =Time.new# Time 的組件
puts "當前時間 : "+ time.inspect
puts time.year # => 日期的年份
puts time.month # => 日期的月份（1 到 12）
puts time.day # => 一個月中的第幾天（1 到 31）
puts time.wday # => 一周中的星期幾（0 是星期日）
puts time.yday # => 365：一年中的第幾天
puts time.hour # => 23：24 小時制
puts time.min # => 59
puts time.sec # => 59
puts time.usec # => 999999：微秒
puts time.zone # => "UTC"：時區名稱
這將產生以下結果：
當前時間:2015-09-1715:24:44+080020159174260152444921519
CST
這些函數可用于格式化標準格式的日期，如下所示：
# July 8, 2008
Time.local(2008, 7, 8)
# July 8, 2008, 09:10am，本地時間
Time.local(2008, 7, 8, 9, 10)
# July 8, 2008, 09:10 UTC
Time.utc(2008, 7, 8, 9, 10)
# July 8, 2008, 09:10:11 GMT （與 UTC 相同）
Time.gm(2008, 7, 8, 9, 10, 11)
下面的實例在數組中獲取所有的組件：
[sec,min,hour,day,month,year,wday,yday,isdst,zone]
嘗試下面的實例：
#!/usr/bin/ruby -w
time =Time.new
values = time.to_a
p values
以上實例運行輸出結果為：
[39,25,15,17,9,2015,4,260,false,"CST"]
該數組可被傳到 Time.utc 或 Time.local 函數來獲取日期的不同格式，如下所示：
#!/usr/bin/ruby -w
time =Time.new
values = time.to_a
puts Time.utc(*values)
以上實例運行輸出結果為：
2015-09-1715:26:09 UTC
下面是獲取時間的方式，從紀元以來的秒數（平臺相關）：
# 返回從紀元以來的秒數
time = Time.now.to_i
# 把秒數轉換為 Time 對象
Time.at(time)
# 返回從紀元以來的秒數，包含微妙
time = Time.now.to_f
您可以使用 Time 對象來獲取與時區和夏令時有關的所有信息，如下所示：
time = Time.new
# 這裡是解釋
time.zone # => "UTC"：返回時區
time.utc_offset # => 0：UTC 是相對於 UTC 的 0 秒偏移
time.zone # => "PST"（或其他時區）
time.isdst # => false：如果 UTC 沒有 DST（夏令時）
time.utc? # => true：如果在 UTC 時區
time.localtime # 轉換為本地時區
time.gmtime # 轉換回 UTC
time.getlocal # 返回本地區中的一個新的 Time 對象
time.getutc # 返回 UTC 中的一個新的 Time 對象
有多種方式格式化日期和時間。下面的實例演示了其中一部分：
#!/usr/bin/ruby -w
time =Time.new
puts time.to_s
puts time.ctime
puts time.localtime
puts time.strftime("%Y-%m-%d %H:%M:%S")
以上實例運行輸出結果為：
2015-09-1715:26:42+0800ThuSep1715:26:4220152015-09-1715:26:42+08002015-09-1715:26:42
時間格式化指令下表所列出的指令與方法 Time.strftime 一起使用。
指令描述%a星期幾名稱的縮寫（比如 Sun）。%A星期幾名稱的全稱（比如 Sunday）。%b月份名稱的縮寫（比如 Jan）。%B月份名稱的全稱（比如 January）。%c優選的本地日期和時間表示法。%d一個月中的第幾天（01 到 31）。%H一天中的第幾小時，24 小時制（00 到 23）。%I一天中的第幾小時，12 小時制（01 到 12）。%j一年中的第幾天（001 到 366）。%m一年中的第幾月（01 到 12）。%M小時中的第幾分鐘（00 到 59）。%p子午線指示（AM 或 PM）。%S分鐘中的第幾秒（00 或 60）。%U當前年中的周數，從第一個星期日（作為第一周的第一天）開始（00 到 53）。%W當前年中的周數，從第一個星期一（作為第一周的第一天）開始（00 到 53）。%w一星期中的第幾天（Sunday 是 0，0 到 6）。%x只有日期沒有時間的優先表示法。%X只有時間沒有日期的優先表示法。%y不帶世紀的年份表示（00 到 99）。%Y帶有世紀的年份。%Z時區名稱。%%% 字符。時間算法您可以用時間做一些簡單的算術，如下所示：
now = Time.now # 當前時間
puts now
past = now - 10 # 10 秒之前。Time - number => Time
puts past
future = now + 10 # 從現在開始 10 秒之後。Time + number => Time
puts future
diff = future - now # => 10 Time - Time => 秒數
puts diff
這將產生以下結果：
Thu Aug 01 20:57:05 -0700 2013
Thu Aug 01 20:56:55 -0700 2013
Thu Aug 01 20:57:15 -0700 2013
10.0