Ruby 的 Time 類別提供強大的時間日期處理能力,支援納秒精度、時區轉換、格式化輸出與時間運算。本文系統整理核心 API 與實戰常用模式。
Time.new # => 當前時間 (含時區)
Time.now # 同 Time.new
Time.now.to_i # Unix 時間戳 (秒)
Time.now.to_f # Unix 時間戳 (浮點秒,含微秒)
time = Time.new
time.year # 年 (如 2024)
time.month # 月 (1-12)
time.day # 日 (1-31)
time.wday # 星期 (0=Sunday..6=Saturday)
time.yday # 年內第幾天 (1-366)
time.hour # 時 (0-23)
time.min # 分 (0-59)
time.sec # 秒 (0-59)
time.usec # 微秒 (0-999999)
time.nsec # 納秒 (Ruby 2.7+)
time.zone # 時區縮寫 (如 "CST", "UTC")
time.utc_offset # 相對 UTC 秒數
time.isdst # 是否夏令時
time.utc? # 是否 UTC
Time.local(2024, 7, 8) # 本地時間
Time.local(2024, 7, 8, 9, 10) # 本地時間 09:10
Time.utc(2024, 7, 8, 9, 10) # UTC 時間
Time.gm(2024, 7, 8, 9, 10, 11) # GMT (同 UTC)
time = Time.new
arr = time.to_a
# => [sec, min, hour, day, month, year, wday, yday, isdst, zone]
Time.utc(*arr) # 陣列轉 UTC 時間
Time.local(*arr) # 陣列轉本地時間
# Time -> timestamp
timestamp = time.to_i # 秒
timestamp = time.to_f # 浮點秒
timestamp = time.to_r # Rational 精確值
# timestamp -> Time
Time.at(timestamp) # 秒 -> Time
Time.at(timestamp, usec) # 秒 + 微秒
Time.at(timestamp, :nsec) # 納秒 (Ruby 2.7+)
time = Time.new
time.localtime # 轉本地時區 (修改 self)
time.gmtime # 轉 UTC (修改 self)
time.getlocal # 返回新的本地時間物件
time.getutc # 返回新的 UTC 物件
time.getlocal("+08:00") # 指定時區偏移 (Ruby 2.7+)
time = Time.new
time.to_s # "2024-01-15 14:30:45 +0800"
time.ctime # "Mon Jan 15 14:30:45 2024"
time.strftime("%Y-%m-%d %H:%M:%S") # 自定義格式
time.iso8601 # "2024-01-15T14:30:45+08:00"
time.rfc2822 # "Mon, 15 Jan 2024 14:30:45 +0800"
time.httpdate # "Mon, 15 Jan 2024 06:30:45 GMT"
| 代碼 | 含義 |
|---|---|
| %Y | 4 位數年 |
| %m | 月 (01-12) |
| %d | 日 (01-31) |
| %H | 時 24制 (00-23) |
| %M | 分 (00-59) |
| %S | 秒 (00-59) |
| %L | 毫秒 (000-999) |
| %N | 納秒 (Ruby 2.7+) |
| %z | 時區偏移 +HHMM |
| %Z | 時區名稱 |
| %A / %a | 完整/縮寫星期名 |
| %B / %b | 完整/縮寫月份名 |
t = Time.now
t + 3600 # 1 小時後 (返回新 Time)
t - 86400 # 1 天前
t + 1.5 # 1.5 秒後
t2 - t1 # 兩時間差 (秒數 Float)
注意:Time 運算以秒為單位。複雜日期運算(月份加減、工作日計算)建議使用 Date、DateTime 或 ActiveSupport::Duration (Rails)。
Time.parse("2024-01-15 14:30:45") # 依靠啟發式解析
Time.strptime("2024-01-15", "%Y-%m-%d") # 指定格式解析
Time.iso8601("2024-01-15T14:30:45+08:00") # ISO 8601
Time.rfc2822("Mon, 15 Jan 2024 14:30:45 +0800")
Time.httpdate("Mon, 15 Jan 2024 06:30:45 GMT")
require 'date'
Date.today # 當前日期 (無時間)
DateTime.now # 當前日期時間 (精度至秒)
time.to_date # Time -> Date
time.to_datetime # Time -> DateTime
date.to_time # Date -> Time (本地時間)
datetime (無時區) 或 timestamptz (PostgreSQL)。Time/TZInfo。Process.clock_gettime(Process::CLOCK_MONOTONIC)。