# **第 20 章　Time 类与 Date 类** 在本章中，我们将会介绍操作时间的 `Time` 类、以及操作日期的 `Date` 类。 - **Time 类与 Date 类** 对 `Time` 类以及 `Date` 类的概要进行说明 - **时间、日期的获取** 介绍获取当前时间、日期的方法。 - **时间、日期的计算** 介绍时间、日期的比较及运算方法。 - **转换为字符串** 介绍把时间、日期转换为字符串的方法。 - **解析字符串** 介绍把表示时间、日期的字符串分别转换为 `Time` 对象、`Date` 对象的方法。 ### **20.1　Time 类与 Date 类** `Time` 类用于表示时间。时间除了表示年月日时分秒的信息以外，还包含了表示地域时差的时区（time zone）信息。例如我们可以计算中国当前时间是国际协调时间的几点。 `Date` 类只用于表示年月日。因此，相对于 `Time` 类以秒为单位计算时间，`Date` 类则是以天为单位进行计算的。`Date` 类还可以求下个月的同一天、本月末等日期。 `Time` 类与 `Date` 类表示时间、日期时并没有什么特别限制（前提是现在的日历能一直用下去，甚至“西历 100 亿年”这样的时间、日期也都是可以表示的）。但实际文件的时间戳、程序的运行时间等系统内的时间、以及数据库中的时间类型数据等的情况下，有时候就会受到执行环境的限制。 ### **20.2　时间的获取** - **`Time.new` `Time.now`** 通过 `Time.new` 方法或者 `Time.now` 方法获取表示当前时间的 `Time` 对象。 ~~~ p Time.new #=> 2013-03-30 03:06:00 +0900 sleep 1 #=> 等待1 秒 p Time.now #=> 2013-03-30 03:06:01 +0900 ~~~ - ***t*.`year` *t*.`month` *t*.`day`** 也可以获取时间对象中的年、月、日。 ~~~ t = Time.now p t #=> 2013-03-30 03:07:13 +0900 p t.year #=> 2013 p t.month #=> 3 p t.day #=> 30 ~~~ 表 20.1 列举了时间的相关方法。 **表 20.1　时间的相关方法** | 方法名 | 意义 | |-----|-----| | `year` | 年 | | `month` | 月 | | `day` | 日 | | `hour` | 时 | | `min` | 分 | | `sec` | 秒 | | `usec` | 秒以下的位数（以毫秒为单位） | | `to_i` | 从 1970 年 1 月 1 日到当前时间的秒数 | | `wday` | 一周中的第几天（0 表示星期天） | | `mday` | 一个月中的第几天（与 `day` 方法一样） | | `yday` | 一年中的第几天（1 表示 1 月 1 日） | | `zone` | 时区（`JST` 等） | - **`Time.mktime`( *year*[*, month*[*,* day[*, hour* [*, min*[*, sec*[*, usec*]]]]]]])** 通过 `Time.mktime` 方法可以根据指定时间获取 `Time` 对象。 ~~~ t = Time.mktime(2013, 5, 30, 3, 11, 12) p t #=> 2013-05-30 03:11:12 +900 ~~~ 文件的创建时间、更新时间等也都能以 `Time` 对象的形式获取。详情请参考 18.3 节。 ### **20.3　时间的计算** `Time` 对象之间可以互相比较、运算。 ~~~ t1 = Time.now sleep(10) # 等10 秒 t2 = Time.now p t1 < t2 #=> true p t2 - t1 #=> 10.005073 ~~~ 还可以增加或减少 `Time` 对象的秒数。 ~~~ t = Time.now p t #=> 2013-03-30 03:11:44 +0900 t2 = t + 60 * 60 * 24 #=> 增加24 小时的秒数 p t2 #=> 2013-03-31 03:11:44 +0900 ~~~ ### **20.4　时间的格式** - ***t*.`strftime`(*format*) *t*.`to_s`** 通过 `Time#strftime` 方法可以把时间转换为遵循某种格式的字符串。表 20.2 为格式（*format*）中可以使用的字符串。 **表 20.2　Time#strftime 中的格式字符串** | 格式 | 意义与范围 | |-----|-----| | `%A` | 星期的名称（`Sunday`、 `Monday`……） | | `%a` | 星期的缩写名称（`Sun`、 `Mon`……） | | `%B` | 月份的名称（`January`、 `February`……） | | `%b` | 月份的缩写（`Jan`、 `Feb`……） | | `%c` | 日期与时间 | | `%d` | 日（01 ～ 31） | | `%H` | 24 小时制（00 ～ 23） | | `%I` | 12 小时制（01 ～ 12） | | `%j` | 一年中的天（001 ～ 366） | | `%M` | 分（00 ～ 59） | | `%m` | 表示月的数字（01 ～ 12） | | `%p` | 上午或下午（AM、PM） | | `%S` | 秒（00 ～ 60） | | `%U` | 表示周的数字。以星期天为一周的开始（00 ～ 53） | | `%W` | 表示周的数字。以星期一为一周的开始（00 ～ 53） | | `%w` | 表示星期的数字。0 表示星期天（0 ～ 6） | | `%X` | 时间 | | `%x` | 日期 | | `%Y` | 表示西历的数字 | | `%y` | 西历的后两位（00 ～ 99） | | `%Z` | 时区（ `JST` 等） | | `%z` | 时区（+0900 等） | | `%%` | 原封不动地输出 `%` | 例如，`Time#to_s` 方法得到的字符串格式与 `"%Y-%m-%d %H:%M:%S %z"` 是等价的。 ~~~ t = Time.now p t.to_s #=> 2013-03-30 03:13:14 +0900 p t.strftime("%Y-%m-%d %H:%M:%S %z") #=> 2013-03-30 03:13:14 +0900 ~~~ > **备注**　`Time#strftime` 方法的格式是与平台相关的，不同平台下的执行结果可能不一样。例如，在 Windows 中，`"%Z"` 的执行结果会显示“中国标准时间”。 - ***t*.`rfc2822`** 通过 `Time#rfc2822` 方法可以生成符合电子邮件头部信息中的 Date ：字段格式的字符串。在互联网的相关文档 RFC（Request For Comments）中，有一个关于电子邮件形式定义的 RFC 2822 文档，`rfc2822` 这个方法名就来自于此。使用这个方法前，需要预先通过 `require "time"` 引用 `time` 库。 ~~~ require "time" 　 t = Time.now p t.rfc2822 #=> "Sat, 30 Mar 2013 03:13:34 +0900" ~~~ - ***t*.`iso8601`** 通过 `Time#iso8691` 方法生成符合 ISO 8601 国际标准的时间格式的字符串。使用这个方法时也需要引用 `time` 库。 ~~~ require "time" 　 t = Time.now p t.iso8601 #=> "2013-03-30T03:13:34+09:00" ~~~ ### **20.5　本地时间** 世界各地都有时差。大家的计算机中也设有时区，一般计算机中的时间都是根据时区来设定的。 - ***t*.`utc` *t*.`localtime`** 我们可以用 `Time#utc` 方法把 `Time` 对象的时区变更为国际协调时间（UTC）。反之，用 `Time#localtime` 方法则可以把 UTC 变更为本地时间。 ~~~ t = Time.now p t #=> 2013-03-30 03:15:19 +0900 t.utc p t #=> 2013-03-29 18:15:19 UTC t.localtime p t #=> 2013-03-30 03:15:19 +0900 ~~~ ### **20.6　从字符串中获取时间** 可以将以字符串形式表示的时间转换为 `Time` 对象。 - **`Time.parse`(*str*)** 通过使用 `require "time"`，我们就可以使用 `Time.parse` 方法，来操作以字符串形式表现的时间。`Time.parse` 方法会解析参数字符串 *str*，返回对应的 `Time` 对象。 `Time.parse` 方法除了可以返回与 `Time#to_s` 方法相同的格式，还可以返回 "*yyyy/mm/dd*" 等多种格式。 ~~~ require "time" 　 p Time.parse("Sat Mar 30 03:54:15 UTC 2013") #=> 2013-03-30 03:54:15 UTC p Time.parse("Sat, 30 Mar 2013 03:54:15 +0900") #=> 2013-03-30 03:54:15 +0900 p Time.parse("2013/03/30") #=> 2013-03-30 00:00:00 +0900 p Time.parse("2013/03/30 03:54:15") #=> 2013-03-30 03:54:15 +0900 p Time.parse("H25.03.31") #=> 2013-03-31 00:00:00 +0900 p Time.parse("S48.9.28") #=> 1973-09-28 00:00:00 +0900 ~~~ ### **20.7　日期的获取** `Date` 类用于处理不包含时间的日期。使用 `Date.today` 方法可以得到表示当前日期的 `Date` 对象。使用 `Date` 类需要引用 `date` 库。 ~~~ require "date" d = Date.today puts d #=> 2013-03-30 ~~~ 与 Time 类一样，日期也有其相关的方法。 ~~~ require "date" d = Date.today p d.year # 年 => 2013 p d.month # 月 => 3 p d.day # 日 => 30 p d.wday # 一周中的第几天（0 表示星期天） => 6 p d.mday # 一个月中的第几天（与 day 方法一样） => 30 p d.yday # 一年中的第几天（1 表示 1 月 1 日） => 89 ~~~ 还可以用指定日期生成 `Date` 对象。 ~~~ require "date" d = Date.new(2013, 3, 30) puts d #=> 2013-03-30 ~~~ `Date` 类有一个特点是，可以对月末的日期做-1 处理（-2 表示月末的前一天）。当然也可以应对闰年。 ~~~ require "date" d = Date.new(2013,2,-1) puts d #=> 2013-02-28 d = Date.new(2016, 2, -1) puts d #=> 2016-02-29 ~~~ ### **20.8　日期的运算** `Date` 对象之间的运算以天为单位。因此，`Date` 对象之间进行减法运算时，返回的是两者之间的天数。日期减法运算的结果不是整数，而是 `Rational` 对象。此外，还可以将 `Date` 对象与整数进行加法、减法等运算，这时会返回该对象前后的日期。 ~~~ require "date" d1 = Date.new(2013, 1, 1) d2 = Date.new(2013, 1, 4) puts d2 - d1 #=> 3/1 (3 天的意思) d = Date.today puts d #=> 2013-03-30 puts d + 1 #=> 2013-03-31 puts d + 100 #=> 2013-07-08 puts d - 1 #=> 2013-03-29 puts d -100 #=> 2012-12-20 ~~~ 通过使用 `>>` 运算符，我们就可以获取后一个月相同日期的 `Date` 对象。同理，使用 `<<` 运算符得到的是表示前一个月相同日期的 `Date` 对象。如果该月中没有相同的日期（例如 2 月 30 日），则会返回月末的日期。 ~~~ require "date" d = Date.today puts d #=> 2013-03-30 puts d >> 1 #=> 2013-04-30 puts d >> 100 #=> 2021-07-30 puts d << 1 #=> 2013-02-28 puts d << 100 #=> 2004-11-30 ~~~ ### **20.9　日期的格式** 与 `Time` 类一样，通过 `strftime` 方法也可以将日期按指定的格式转换为字符串。但结果中时间的部分会全部变为 0。 ~~~ require "date" t = Date.today p t.strftime("%Y/%m/%d %H:%M:%S") #=> "2013/03/30 00:00:00" p t.strftime("%a %b %d %H:%M:%S %Z %Y") #=> "Sat Mar 30 00:00:00 +00:00 2013" p t.to_s #=> "2013-03-30" ~~~ ### **20.10　从字符串中获取日期** 使用 `Date.parse` 方法可以将字符串转换为日期。这个方法可以应对多种日期格式。 ~~~ require "date" puts Date.parse("Sat Mar 30 03:50:12 JST 2013") #=> 2013-03-30 puts Date.parse("H25.05.30") #=> 2013-05-30 puts Date.parse("S48.9.28") #=> 1973-09-28 ~~~ ### **练习题** 1. 定义 `cparsedate` 方法，把“2013 年 5 月 30 日下午 8 点 17 分 50 秒”这种使用了“年月日时分秒”的字符串转换为 `Time` 对象。 2. 定义 `ls_t` 方法，把指定目录下的文件按时间顺序排列，就像 Unix 的 ls -t 命令那样。这个方法只有一个参数。 **`ls_t`( 目录名)** 将指定目录下的文件名按照时间从小到大的顺序排列并输出。 3. 使用 `Date` 类获取本月中每天所对应的星期，并按以下日历格式输出结果。 ~~~ May 2013 Su Mo Tu We Th Fr Sa 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 ~~~ > 参考答案：请到图灵社区本书的“随书下载”处下载（[http://www.ituring.com.cn/book/1237](http://www.ituring.com.cn/book/1237)）。