时间对象. Time.now返回当前时间. 由File#stat所返回的文件的时间标记正是Time对象.
Time对象中保存的是自起算时间以来所经过的秒数. 起算时间定在协调世界时(UTC,或旧称GMT)的1970年1月1日上午0点。系统内部保存了一个标识,用来确定Time对象是采用协调世界时的时区还是采用地方时的时区：
p Marshal.load(Marshal.dump(Time.now.gmtime)).zone
=>"UTC"
Time.at(time[, usec])
返回time所指时间的Time对象
Time.at(0,0)
=>1970-01-01 08:00:00 +0800
Time.gm(year[, mon[, day[, hour[, min[, sec[, usec]]]]]])
Time.gm(sec, min, hour, mday, mon, year, wday, yday, isdst, zone)
Time.utc(year[, mon[, day[, hour[, min[, sec[, usec]]]]]])
Time.utc(sec, min, hour, mday, mon, year, wday, yday, isdst, zone)
返回由参数指定的协调世界时的Time对象. 第1参数后面的全是可选参数. 若省略这些参数的话,将使用最小的可能值.
Time.utc(2013)
=>2013-01-01 00:00:00 UTC
Time.local(year[, mon[, day[, hour[, min[, sec[, usec]]]]]])
Time.local(sec, min, hour, mday, mon, year, wday, yday, isdst, zone)
Time.mktime(year[, mon[, day[, hour[, min[, sec[, usec]]]]]])
Time.mktime(sec, min, hour, mday, mon, year, wday, yday, isdst, zone)
返回由参数指定的地方时的Time对象.
Time.local(2013,2,14,2,14)
=>2013-02-14 02:14:00 +0800
Time.new
Time.now
返回当前时间的Time对象. new与now的区别在于,它会调用initialize.
Time.now
=>2013-02-14 02:14:00 +0800
self + other
返回self之后other秒的时间.
Time.now+12
=>2013-02-14 02:14:12 +0800
self - other
若other是Time对象的话,就以Float形式返回这二者间的时间差,单位是秒. 若other是数值时, 就返回self之前other秒钟的时间.
Time.now-12
=>2013-02-14 02:13:48 +0800
self <=> other
时间的比较. other必需是Time对象或数值.若是数值的话, 就把它当做自起算时间以来经过的秒数,然后进行比较.
asctime
ctime
将时间变为asctime(3)形式的字符串. 但不包含末尾的 \n .
Time.now.ctime
=>"Mon Mar 18 15:59:04 2013"
gmt?
utc?
若self的时区是协调世界时的话,就返回真.
Time.now.gmt?
=>false
Time.now.utc?
=>false
getgm
getutc
新生成并返回一个时区设为协调世界时的Time对象.
Time.now.getgm
=>2013-03-18 08:01:35 UTC
Time.now.getgm.gmt?
=>true
getlocal
新生成并返回一个时区设为地方时的Time对象
Time.now.getlocal
=>2013-03-18 16:03:16 +0800
gmtime
utc
将时区设为协调世界时.返回self.
Time.now.utc
=>2013-03-18 08:01:35 UTC
strftime(format)
按照format字符串的模式,将时间变为字符串,并返回结果. format字符串可以使用下列形式.
%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) (60是闰秒)
%U: 表示周的数字.以第一个星期天作为第一周的开始(00-53)
%W: 表示周的数字.以第一个星期一作为第一周的开始(00-53)
%w: 表示星期几的数字. 星期天是0(0-6)
%X: 时刻
%x: 日期
%Y: 表示公历年份的数字
%y: 公历年份的后两位数字(00-99)
%Z: 时区trap
%%: %本身
sec
min
hour
mday
day
mon
month
year
wday
yday
isdst
dst?
zone
返回时间的要素
Time.now.ctime
=>"Mon Mar 18 15:59:04 2013"
Time.now.wday
=>1
Time.now.mday
=>18
Time.now.yday
=>77
succ
将self加上1秒钟以后生成并返回一个Time对象. 时区采用地方时.
utc_offset
gmt_offset
gmtoff
返回一个以秒为单位的数值, 该数值显示了与协调世界时之间的时差.
Time.now.utc_offset
=>28800
to_a
以一个包括10个元素的数组的形式返回某时间. 数组元素的排列如下.
sec: 秒 (整数 0-60)
min: 分 (整数 0-60)
hour: 时 (整数 1-24)
mday: 日 (整数)
mon: 月 (整数 1-12)
year: 年 (整数 2000钳=2000)
wday: 星期几 (整数 0-6)
yday: 一年的第几天 (整数 1-366)
isdst: 有无夏令时 (true/false)
zone: 时区 (字符串)
Time.now
=>2013-03-18 16:10:03 +0800
Time.now.to_a
=>[3,10,16,18,3,2013,1,77,false,"China Standard Time"]
to_f
以浮点数形式返回自起算时间以来经过的秒数. 它可以表示那些非整秒的情况
to_i
tv_sec
以整数形式返回自起算时间以来经过的秒数.
to_s
将某时刻变换为形如date(1)形式的字符串, 等同于：
elf.strftime("%a %b %d %H:%M:%S %Z %Y")
