Ruby 日期 & 時間（Date & Time）

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

以上實例運行輸出結果為：

當前時間 : 2015-09-17 15:23:14 +0800
當前時間 : 2015-09-17 15:23:14 +0800

獲取 Date & Time 組件

我們可以使用 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-17 15:24:44 +0800
2015
9
17
4
260
15
24
44
921519
CST

Time.utc、Time.gm 和 Time.local 函數

這些函數可用於格式化標準格式的日期，如下所示：

# 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-17 15: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-17 15:26:42 +0800
Thu Sep 17 15:26:42 2015
2015-09-17 15:26:42 +0800
2015-09-17 15: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

以上實例運行輸出結果為：

2015-09-17 15:27:08 +0800
2015-09-17 15:26:58 +0800
2015-09-17 15:27:18 +0800
10.0