prev - up - next - index

Time

The Time class represents the time value and its operations. Time.now returns the current time object. The timestamps of the files returned by File#stat are instances of this class.

SuperClass:

Object

Included Modules:

Comparable

Class Methods:

now
now

Returns the current time object.

at(time)

Creates the time object at time. The argument time must be either the instance of the Time class or the number, which is considered as seconds since 00:00:00 GMT, January 1, 1970.

gm(year, month, day, hour, min, sec)

Returns the Time object specified by the arguments in GMT. The arguments after the second one can be omitted. The default value for the omitted argument is the lowest value for that argument.

If the month argument is a fixnum, it must be from 0(January) to 11(December). If it is string, it must be the English month name or the number starting from 1(January) to 12(December).

local(year, month, day, hour, min, sec)
mktime(year, month, day, hour, min, sec)

Returns the Time object specified by the arguments in localtime. The arguments after the second one can be omitted. The default value for the omitted argument is the lowest value for that argument.

times

Returns the user and system CPU times structure, which attributes are:

utime		# user time
stime		# system time
cutime		# user time of children
cstime		# system time of children

Times are floating-point numbers and are measured in seconds. (See times(3))

Methods:

self + other

Returns the time object which is later than self by other.

self - other

Returns the diff of the time in float, if the other if the time object. If the other is the numeric value, it returns the time object earlier than self than other.

self <=> other

Comparison of the times. other must be a time object or an integer or a floating-point number. Numbers are considered as seconds since 00:00:00 GMT, January 1, 1970.

asctime
ctime
to_s

Converts the time into the string form like ctime(3).

coerce(number)

Converts self and the number into mutually calculatable numbers. The Time object can be mixed with numeric value in calculation.

gmtime

Sets timezone of the time object to GMT. The time object operates time in GMT thereafter. To print time in London:

print Time.now.gmtime, "\n"

gmtime returns self.

localtime

Sets timezone of the time object to localtime, which is default. Returns time object itself.

to_i
tv_sec

Returns the time since the epoch, 00:00:00 GMT, January 1, 1970, measured in seconds.

sec
min
hour
mday
mon
year
wday
yday
zone
isdst

Returns the internal values of the time object. All methods return an integer value, except zone, which returns the timezone name string. (c.f. localtime(3))

strftime(format)

Returns formatted string from the time object. Format specifiers are as follows:

%A
full weekday name(Sunday, Monday...)
%a
abbreviated weekday name(Sun, Mon...)
%B
full month name(January, February...)
%b
abbreviated month name(Jan, Feb...)
%c
time representation(c.f. ctime(3))
%d
day of the month in decimal(01-31)
%H
hour using a 24-hour clock(00-23)
%I
hour using a 12-hour clock(01-12)
%j
day of the year(001-366)
%M
minutes(00-59)
%m
month in decimal(01-12)
%p
Either AM or PM
%S
second in decimal(00-61)
%U
week number, first Sunday as the first day of the first week(00-53)
%W
week number, first Monday as the first day of the first week(00-53)
%w
day of the week in number. Sunday being 0(0-6)
%X
time representation without date(ex. 15:01:06)
%x
time representation without time(ex. Fri Jan 14 1994)
%Y
year
%y
year without century(00-99)
%Z
timezone
%%
%itself
to_f

Converts the time (in seconds from the epoch) into a floating-point number.

usec
tv_usec

Returns micro second part of the time object.


prev - up - next - index

matz@caelum.co.jp