Ruby - 日期與時間

在 Ruby 中，Time 類表示日期和時間。它是在作業系統提供的系統日期和時間功能之上的一層薄薄的封裝。此類可能無法在您的系統上表示 1970 年之前的日期或 2038 年之後的日期。

本章使您熟悉所有最需要的日期和時間概念。

獲取當前日期和時間

以下是獲取當前日期和時間的簡單示例：

#!/usr/bin/ruby -w

time1 = Time.new
puts "Current Time : " + time1.inspect

# Time.now is a synonym:
time2 = Time.now
puts "Current Time : " + 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

time = Time.new

# Components of a Time
puts "Current Time : " + time.inspect
puts time.year    # => Year of the date 
puts time.month   # => Month of the date (1 to 12)
puts time.day     # => Day of the date (1 to 31 )
puts time.wday    # => 0: Day of week: 0 is Sunday
puts time.yday    # => 365: Day of year
puts time.hour    # => 23: 24-hour clock
puts time.min     # => 59
puts time.sec     # => 59
puts time.usec    # => 999999: microseconds
puts time.zone    # => "UTC": timezone name

這將產生以下結果：

Current Time : Mon Jun 02 12:03:08 -0700 2008
2008
6
2
1
154
12
3
8
247476
UTC

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

這兩個函式可用於以標準格式格式化日期，如下所示：

# July 8, 2008
Time.local(2008, 7, 8)  
# July 8, 2008, 09:10am, local time
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 (same as 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

這將生成以下結果：

[26, 10, 12, 2, 6, 2008, 1, 154, false, "MST"]

此陣列可以傳遞給 Time.utc 或 Time.local 函式以獲取不同格式的日期，如下所示：

線上演示

#!/usr/bin/ruby -w

time = Time.new
values = time.to_a
puts Time.utc(*values)

這將生成以下結果：

Mon Jun 02 12:15:36 UTC 2008

以下是如何獲取自（平臺相關）紀元以來的秒數表示的時間：

# Returns number of seconds since epoch
time = Time.now.to_i  

# Convert number of seconds into Time object.
Time.at(time)

# Returns second since epoch which includes microseconds
time = Time.now.to_f

時區和夏令時

您可以使用 Time 物件獲取與時區和夏令時相關的所有資訊，如下所示：

time = Time.new

# Here is the interpretation
time.zone       # => "UTC": return the timezone
time.utc_offset # => 0: UTC is 0 seconds offset from UTC
time.zone       # => "PST" (or whatever your timezone is)
time.isdst      # => false: If UTC does not have DST.
time.utc?       # => true: if t is in UTC time zone
time.localtime  # Convert to local timezone.
time.gmtime     # Convert back to UTC.
time.getlocal   # Return a new Time object in local zone
time.getutc     # Return a new Time object in UTC

格式化時間和日期

有多種方法可以格式化日期和時間。以下是一個顯示一些示例：

線上演示

#!/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")

這將產生以下結果：

Mon Jun 02 12:35:19 -0700 2008
Mon Jun  2 12:35:19 2008
Mon Jun 02 12:35:19 -0700 2008
2008-06-02 12:35:19

時間格式化指令

下表中的這些指令與 Time.strftime 方法一起使用。

序號	指令及說明
1	%a 縮寫的工作日名稱（Sun）。
2	%A 完整的工作日名稱（Sunday）。
3	%b 縮寫的月份名稱（Jan）。
4	%B 完整的月份名稱（January）。
5	%c 首選的本地日期和時間表示形式。
6	%d 月份中的日期（01 到 31）。
7	%H 一天中的小時，24 小時制（00 到 23）。
8	%I 一天中的小時，12 小時制（01 到 12）。
9	%j 一年中的日期（001 到 366）。
10	%m 一年中的月份（01 到 12）。
11	%M 小時中的分鐘（00 到 59）。
12	%p 子午線指示符（AM 或 PM）。
13	%S 分鐘中的秒數（00 到 60）。
14	%U 當前年份的星期數，從第一個星期日作為第一週的第一天開始（00 到 53）。
15	%W 當前年份的星期數，從第一個星期一作為第一週的第一天開始（00 到 53）。
16	%w 星期幾（星期日為 0，0 到 6）。
17	%x 僅日期的首選表示形式，無時間。
18	%X 僅時間的首選表示形式，無日期。
19	%y 不帶世紀的年份（00 到 99）。
20	%Y 帶世紀的年份。
21	%Z 時區名稱。
22	%% 文字 % 字元。

時間算術

您可以對時間執行簡單的算術運算，如下所示：

線上演示

now = Time.now          # Current time
puts now

past = now - 10         # 10 seconds ago. Time - number => Time
puts past

future = now + 10  # 10 seconds from now Time + number => Time
puts future

diff = future - past     # => 10  Time - Time => number of seconds
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
20.0

列印頁面