Ruby Time.utc用法及代码示例

本文简要介绍ruby语言中 Time.utc 的用法。

用法

utc(year, month=1, day=1, hour=0, min=0, sec_i=0, usec=0) → new_time

utc(sec_i, min, hour, day, month, year, dummy, dummy, dummy, dummy) → new_time

根据给定的参数返回一个新的 Time 对象；它的时区是UTC。

在第一种形式(最多七个参数)中，需要参数year。

Time.utc(2000)                  # => 2000-01-01 00:00:00 UTC
Time.utc(0, 1, 2, 3, 4, 5, 6.5) # => 0000-01-02 03:04:05.0000065 UTC

在第二种形式中，所有十个参数都是必需的，尽管最后四个被忽略了。这种形式对于从 10 元素数组(例如由 to_a 返回的)创建时间很有用。

array = Time.now.to_a
p array # => [57, 26, 13, 24, 4, 2021, 6, 114, true, "Central Daylight Time"]
array[5] = 2000
Time.utc(*array) # => 2000-04-24 13:26:57 UTC

参数：

year ：整数年。
month ：月份值，可能是：
- 1..12 范围内的整数月份。
- 与正则表达式 /jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec/i 匹配的 3 字符字符串。
day ：1..31 范围内的整数天(某些月份小于 31)。
hour : 0..23 范围内的整数小时。
min : 0..59 范围内的整数分钟。
isec_i 是 0..60 范围内的整数秒数。
usec 是 0..1000000 范围内的微秒数( Integer 、 Float 或 Rational )。

别名：Time.gm。