# Ruby 日期 & 時間（Date & Time） **Time** 類在 Ruby 中用于表示日期和時間。它是基于操作系統提供的系統日期和時間之上。該類可能無法表示 1970 年之前或者 2038 年之后的日期。 本教程將讓您熟悉日期和時間的所有重要的概念。 ## 創建當前的日期和時間 下面是獲取當前的日期和時間的簡單實例： ``` #!/usr/bin/ruby -w time1 = Time.new puts "Current Time : " + time1.inspect # Time.now 是一個同義詞 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 ``` ## 獲取 Date & Time 組件 我們可以使用 _Time_ 對象來獲取各種日期和時間的組件。請看下面的實例： ``` #!/usr/bin/ruby -w time = Time.new # Time 的組件 puts "Current Time : " + 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"：時區名稱 ``` 這將產生以下結果： ``` 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，本地時間 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 ``` 這將產生以下結果： ``` [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 ``` 下面是獲取時間的方式，從紀元以來的秒數（平臺相關）： ``` # 返回從紀元以來的秒數 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") ``` 這將產生以下結果： ``` 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_ 一起使用。 | 指令 | 描述 | | --- | --- | | %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 ```