time 类在 ruby 中用于表示日期和时间。它是基于操作系统提供的系统日期和时间之上。该类可能无法表示 1970 年之前或者 2038 年之后的日期。
本教程将让您熟悉日期和时间的所有重要的概念。
下面是获取当前的日期和时间的简单实例：
这将产生以下结果：
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 # -*- coding: utf-8 -*- time = time.new # time 的组件 puts "当前时间 : " + 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"：时区名称
这将产生以下结果：
当前时间 : 2015-09-17 15:24:44 +0800 2015 9 17 4 260 15 24 44 921519 cst
这些函数可用于格式化标准格式的日期，如下所示：
# 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
以上实例运行输出结果为：
[39, 25, 15, 17, 9, 2015, 4, 260, false, "cst"]
该数组可被传到 time.utc 或 time.local 函数来获取日期的不同格式，如下所示：
#!/usr/bin/ruby -w time = time.new values = time.to_a puts time.utc(*values)
以上实例运行输出结果为：
2015-09-17 15:26:09 utc
下面是获取时间的方式，从纪元以来的秒数（平台相关）：
# 返回从纪元以来的秒数 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")
以上实例运行输出结果为：
2015-09-17 15:26:42 +0800 thu sep 17 15:26:42 2015 2015-09-17 15:26:42 +0800 2015-09-17 15:26:42
下表所列出的指令与方法 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
