返回首页 Ruby 中文版

Ruby 教程

Ruby 高级教程

Ruby 日期 & 时间

Time 类在 Ruby 中用于表示日期和时间。它是基于操作系统提供的系统日期和时间之上。该类可能无法表示 1970 年之前或者 2038 年之后的日期。

本教程将让您熟悉日期和时间的所有重要的概念。

创建当前的日期和时间

下面是获取当前的日期和时间的简单实例:

    #!/usr/bin/ruby -w

    time1 = Time.new

    puts "Current Time : " + time1.inspect

    # Time.now 是一个同义词
    time2 = Time.now
    puts "Current Time : " + time2.inspect

这将产生以下结果:

    Current Time : Mon Jun 02 12:02:39 -0700 2008
    Current Time : Mon Jun 02 12:02:39 -0700 2008

获取 Date & Time 组件

我们可以使用 Time 对象来获取各种日期和时间的组件。请看下面的实例:

    #!/usr/bin/ruby -w

    time = Time.new

    # Time 的组件
    puts "Current Time : " + 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":时区名称

这将产生以下结果:

    Current Time : Mon Jun 02 12:03:08 -0700 2008
    2008
    6
    2
    1
    154
    12
    3
    8
    247476
    UTC

Time.utc、Time.gm 和 Time.local 函数

这些函数可用于格式化标准格式的日期,如下所示:

    # 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

这将产生以下结果:

    [26, 10, 12, 2, 6, 2008, 1, 154, false, "MST"]

该数组可被传到 Time.utcTime.local 函数来获取日期的不同格式,如下所示:

    #!/usr/bin/ruby -w

    time = Time.new

    values = time.to_a
    puts Time.utc(*values)

这将产生以下结果:

    Mon Jun 02 12:15:36 UTC 2008

下面是获取时间的方式,从纪元以来的秒数(平台相关):

    # 返回从纪元以来的秒数
    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")

这将产生以下结果:

    Mon Jun 02 12:35:19 -0700 2008
    Mon Jun  2 12:35:19 2008
    Mon Jun 02 12:35:19 -0700 2008
    2008-06-02 12:35:19

时间格式化指令

下表所列出的指令与方法 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