萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Ruby Time 類別完整指南:時間獲取、元件存取、格式化、時區與運算

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"

常用 strftime 格式代碼

代碼含義
%Y4 位數年
%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")

Date / DateTime 協作


require 'date'
Date.today              # 當前日期 (無時間)
DateTime.now            # 當前日期時間 (精度至秒)
time.to_date            # Time -> Date
time.to_datetime        # Time -> DateTime
date.to_time            # Date -> Time (本地時間)

最佳實踐

  • 儲存時間統一用 UTC,顯示時轉換為使用者時區。
  • 資料庫欄位使用 datetime (無時區) 或 timestamptz (PostgreSQL)。
  • 避免在業務邏輯中手動處理夏令時,交給 Time/TZInfo。
  • 高精度需求(基準測試、科學計算)用 Process.clock_gettime(Process::CLOCK_MONOTONIC)。
copyright © 萬盛學電腦網 all rights reserved