Class Time
In: time.c
lib/date.rb
lib/rss/rss.rb
lib/time.rb
lib/yaml/rubytypes.rb
Parent: Object

Implements the extensions to the Time class that are described in the documentation for the time.rb library.

Methods

+   -   <=>   _dump   _load   apply_offset   asctime   at   ctime   day   dst?   eql?   getgm   getlocal   getutc   gm   gmt?   gmt_offset   gmtime   gmtoff   hash   hour   httpdate   httpdate   inspect   isdst   iso8601   local   localtime   make_time   marshal_dump   marshal_load   mday   min   mktime   mon   month   month_days   new   now   parse   rfc2822   rfc2822   rfc822   sec   strftime   succ   times   to_a   to_date   to_datetime   to_f   to_i   to_s   to_yaml   tv_sec   tv_usec   usec   utc   utc   utc?   utc_offset   w3cdtf   w3cdtf   wday   xmlschema   xmlschema   yaml_new   yday   year   zone   zone_offset   zone_utc?  

Included Modules

Comparable

Constants

ZoneOffset = { 'UTC' => 0, # ISO 8601 'Z' => 0, # RFC 822 'UT' => 0, 'GMT' => 0, 'EST' => -5, 'EDT' => -4, 'CST' => -6, 'CDT' => -5, 'MST' => -7, 'MDT' => -6, 'PST' => -8, 'PDT' => -7, # Following definition of military zones is original one. # See RFC 1123 and RFC 2822 for the error in RFC 822. 'A' => +1, 'B' => +2, 'C' => +3, 'D' => +4, 'E' => +5, 'F' => +6, 'G' => +7, 'H' => +8, 'I' => +9, 'K' => +10, 'L' => +11, 'M' => +12, 'N' => -1, 'O' => -2, 'P' => -3, 'Q' => -4, 'R' => -5, 'S' => -6, 'T' => -7, 'U' => -8, 'V' => -9, 'W' => -10, 'X' => -11, 'Y' => -12, }
LeapYearMonthDays = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
CommonYearMonthDays = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
MonthValue = { 'JAN' => 1, 'FEB' => 2, 'MAR' => 3, 'APR' => 4, 'MAY' => 5, 'JUN' => 6, 'JUL' => 7, 'AUG' => 8, 'SEP' => 9, 'OCT' =>10, 'NOV' =>11, 'DEC' =>12
RFC2822_DAY_NAME = [ 'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'
RFC2822_MONTH_NAME = [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'

External Aliases

rfc2822 -> rfc822
xmlschema -> iso8601

Public Class methods

Unmarshal a dumped Time object.

[Source]

/*
 * call-seq:
 *   Time._load(string)   => time
 *
 * Unmarshal a dumped +Time+ object.
 */

static VALUE
time_load(klass, str)
    VALUE klass, str;
{
    VALUE time = time_s_alloc(klass);

    if (FL_TEST(str, FL_EXIVAR)) {
        rb_copy_generic_ivar(time, str);
        FL_SET(time, FL_EXIVAR);
    }
    time_mload(time, str);
    return time;
}

Creates a new time object with the value given by aTime, or the given number of seconds (and optional microseconds) from epoch. A non-portable feature allows the offset to be negative on some systems.

   Time.at(0)            #=> Wed Dec 31 18:00:00 CST 1969
   Time.at(946702800)    #=> Fri Dec 31 23:00:00 CST 1999
   Time.at(-284061600)   #=> Sat Dec 31 00:00:00 CST 1960

[Source]

/*
 *  call-seq:
 *     Time.at( aTime ) => time
 *     Time.at( seconds [, microseconds] ) => time
 *  
 *  Creates a new time object with the value given by <i>aTime</i>, or
 *  the given number of <i>seconds</i> (and optional
 *  <i>microseconds</i>) from epoch. A non-portable feature allows the
 *  offset to be negative on some systems.
 *     
 *     Time.at(0)            #=> Wed Dec 31 18:00:00 CST 1969
 *     Time.at(946702800)    #=> Fri Dec 31 23:00:00 CST 1999
 *     Time.at(-284061600)   #=> Sat Dec 31 00:00:00 CST 1960
 */

static VALUE
time_s_at(argc, argv, klass)
    int argc;
    VALUE *argv;
    VALUE klass;
{
    struct timeval tv;
    VALUE time, t;

    if (rb_scan_args(argc, argv, "11", &time, &t) == 2) {
        tv.tv_sec = NUM2LONG(time);
        tv.tv_usec = NUM2LONG(t);
    }
    else {
        tv = rb_time_timeval(time);
    }
    t = time_new_internal(klass, tv.tv_sec, tv.tv_usec);
    if (TYPE(time) == T_DATA && RDATA(time)->dfree == time_free) {
        struct time_object *tobj, *tobj2;

        GetTimeval(time, tobj);
        GetTimeval(t, tobj2);
        tobj2->gmt = tobj->gmt;
    }
    return t;
}

Creates a time based on given values, interpreted as UTC (GMT). The year must be specified. Other values default to the minimum value for that field (and may be nil or omitted). Months may be specified by numbers from 1 to 12, or by the three-letter English month names. Hours are specified on a 24-hour clock (0..23). Raises an ArgumentError if any values are out of range. Will also accept ten arguments in the order output by Time#to_a.

   Time.utc(2000,"jan",1,20,15,1)  #=> Sat Jan 01 20:15:01 UTC 2000
   Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000

[Source]

/*
 *  call-seq:
 *     Time.utc( year [, month, day, hour, min, sec, usec] ) => time
 *     Time.utc( sec, min, hour, day, month, year, wday, yday, isdst, tz
 *     ) => time
 *     Time.gm( year [, month, day, hour, min, sec, usec] ) => time
 *     Time.gm( sec, min, hour, day, month, year, wday, yday, isdst, tz
 *     ) => time
 *     
 *  Creates a time based on given values, interpreted as UTC (GMT). The
 *  year must be specified. Other values default to the minimum value
 *  for that field (and may be <code>nil</code> or omitted). Months may
 *  be specified by numbers from 1 to 12, or by the three-letter English
 *  month names. Hours are specified on a 24-hour clock (0..23). Raises
 *  an <code>ArgumentError</code> if any values are out of range. Will
 *  also accept ten arguments in the order output by
 *  <code>Time#to_a</code>.
 *
 *     Time.utc(2000,"jan",1,20,15,1)  #=> Sat Jan 01 20:15:01 UTC 2000
 *     Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 */
static VALUE
time_s_mkutc(argc, argv, klass)
    int argc;
    VALUE *argv;
    VALUE klass;
{
    return time_utc_or_local(argc, argv, Qtrue, klass);
}

Parses date as HTTP-date defined by RFC 2616 and converts it to a Time object.

ArgumentError is raised if date is not compliant with RFC 2616 or Time class cannot represent specified date.

See httpdate for more information on this format.

[Source]

     # File lib/time.rb, line 310
310:     def httpdate(date)
311:       if /\A\s*
312:           (?:Mon|Tue|Wed|Thu|Fri|Sat|Sun),\x20
313:           (\d{2})\x20
314:           (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\x20
315:           (\d{4})\x20
316:           (\d{2}):(\d{2}):(\d{2})\x20
317:           GMT
318:           \s*\z/ix =~ date
319:         self.rfc2822(date)
320:       elsif /\A\s*
321:              (?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday),\x20
322:              (\d\d)-(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-(\d\d)\x20
323:              (\d\d):(\d\d):(\d\d)\x20
324:              GMT
325:              \s*\z/ix =~ date
326:         self.parse(date)
327:       elsif /\A\s*
328:              (?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\x20
329:              (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\x20
330:              (\d\d|\x20\d)\x20
331:              (\d\d):(\d\d):(\d\d)\x20
332:              (\d{4})
333:              \s*\z/ix =~ date
334:         self.utc($6.to_i, MonthValue[$1.upcase], $2.to_i,
335:                  $3.to_i, $4.to_i, $5.to_i)
336:       else
337:         raise ArgumentError.new("not RFC 2616 compliant date: #{date.inspect}")
338:       end
339:     end

Same as Time::gm, but interprets the values in the local time zone.

   Time.local(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000

[Source]

/*
 *  call-seq:
 *     Time.local( year [, month, day, hour, min, sec, usec] ) => time
 *     Time.local( sec, min, hour, day, month, year, wday, yday, isdst,
 *     tz ) => time
 *     Time.mktime( year, month, day, hour, min, sec, usec )   => time
 *  
 *  Same as <code>Time::gm</code>, but interprets the values in the
 *  local time zone.
 *     
 *     Time.local(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000
 */

static VALUE
time_s_mktime(argc, argv, klass)
    int argc;
    VALUE *argv;
    VALUE klass;
{
    return time_utc_or_local(argc, argv, Qfalse, klass);
}

Same as Time::gm, but interprets the values in the local time zone.

   Time.local(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000

[Source]

/*
 *  call-seq:
 *     Time.local( year [, month, day, hour, min, sec, usec] ) => time
 *     Time.local( sec, min, hour, day, month, year, wday, yday, isdst,
 *     tz ) => time
 *     Time.mktime( year, month, day, hour, min, sec, usec )   => time
 *  
 *  Same as <code>Time::gm</code>, but interprets the values in the
 *  local time zone.
 *     
 *     Time.local(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000
 */

static VALUE
time_s_mktime(argc, argv, klass)
    int argc;
    VALUE *argv;
    VALUE klass;
{
    return time_utc_or_local(argc, argv, Qfalse, klass);
}

Document-method: now

Synonym for Time.new. Returns a Time object initialized tot he current system time.

Returns a Time object initialized to the current system time. Note: The object created will be created using the resolution available on your system clock, and so may include fractional seconds.

   a = Time.new      #=> Wed Apr 09 08:56:03 CDT 2003
   b = Time.new      #=> Wed Apr 09 08:56:03 CDT 2003
   a == b            #=> false
   "%.6f" % a.to_f   #=> "1049896563.230740"
   "%.6f" % b.to_f   #=> "1049896563.231466"

[Source]

/*
 *  Document-method: now
 *
 *  Synonym for <code>Time.new</code>. Returns a +Time+ object
 *  initialized tot he current system time.
 *
 *  call-seq:
 *     Time.new -> time
 *  
 *  Returns a <code>Time</code> object initialized to the current system
 *  time. <b>Note:</b> The object created will be created using the
 *  resolution available on your system clock, and so may include
 *  fractional seconds.
 *     
 *     a = Time.new      #=> Wed Apr 09 08:56:03 CDT 2003
 *     b = Time.new      #=> Wed Apr 09 08:56:03 CDT 2003
 *     a == b            #=> false
 *     "%.6f" % a.to_f   #=> "1049896563.230740"
 *     "%.6f" % b.to_f   #=> "1049896563.231466"
 *     
 */

static VALUE
time_init(time)
    VALUE time;
{
    struct time_object *tobj;

    time_modify(time);
    GetTimeval(time, tobj);
    tobj->tm_got=0;
    tobj->tv.tv_sec = 0;
    tobj->tv.tv_usec = 0;
    if (gettimeofday(&tobj->tv, 0) < 0) {
        rb_sys_fail("gettimeofday");
    }

    return time;
}
Time.new → time

Synonym for Time.new. Returns a Time object initialized tot he current system time.

Returns a Time object initialized to the current system time. Note: The object created will be created using the resolution available on your system clock, and so may include fractional seconds.

   a = Time.new      #=> Wed Apr 09 08:56:03 CDT 2003
   b = Time.new      #=> Wed Apr 09 08:56:03 CDT 2003
   a == b            #=> false
   "%.6f" % a.to_f   #=> "1049896563.230740"
   "%.6f" % b.to_f   #=> "1049896563.231466"

Parses date using Date._parse and converts it to a Time object.

If a block is given, the year described in date is converted by the block. For example:

    Time.parse(...) {|y| y < 100 ? (y >= 69 ? y + 1900 : y + 2000) : y}

If the upper components of the given time are broken or missing, they are supplied with those of now. For the lower components, the minimum values (1 or 0) are assumed if broken or missing. For example:

    # Suppose it is "Thu Nov 29 14:33:20 GMT 2001" now and
    # your timezone is GMT:
    Time.parse("16:30")     #=> Thu Nov 29 16:30:00 GMT 2001
    Time.parse("7/23")      #=> Mon Jul 23 00:00:00 GMT 2001
    Time.parse("Aug 31")    #=> Fri Aug 31 00:00:00 GMT 2001

Since there are numerous conflicts among locally defined timezone abbreviations all over the world, this method is not made to understand all of them. For example, the abbreviation "CST" is used variously as:

    -06:00 in America/Chicago,
    -05:00 in America/Havana,
    +08:00 in Asia/Harbin,
    +09:30 in Australia/Darwin,
    +10:30 in Australia/Adelaide,
    etc.

Based on the fact, this method only understands the timezone abbreviations described in RFC 822 and the system timezone, in the order named. (i.e. a definition in RFC 822 overrides the system timezone definition.) The system timezone is taken from Time.local(year, 1, 1).zone and Time.local(year, 7, 1).zone. If the extracted timezone abbreviation does not match any of them, it is ignored and the given time is regarded as a local time.

ArgumentError is raised if Date._parse cannot extract information from date or Time class cannot represent specified date.

This method can be used as fail-safe for other parsing methods as:

  Time.rfc2822(date) rescue Time.parse(date)
  Time.httpdate(date) rescue Time.parse(date)
  Time.xmlschema(date) rescue Time.parse(date)

A failure for Time.parse should be checked, though.

[Source]

     # File lib/time.rb, line 239
239:     def parse(date, now=self.now)
240:       d = Date._parse(date, false)
241:       year = d[:year]
242:       year = yield(year) if year && block_given?
243:       make_time(year, d[:mon], d[:mday], d[:hour], d[:min], d[:sec], d[:sec_fraction], d[:zone], now)
244:     end

Parses date as date-time defined by RFC 2822 and converts it to a Time object. The format is identical to the date format defined by RFC 822 and updated by RFC 1123.

ArgumentError is raised if date is not compliant with RFC 2822 or Time class cannot represent specified date.

See rfc2822 for more information on this format.

[Source]

     # File lib/time.rb, line 261
261:     def rfc2822(date)
262:       if /\A\s*
263:           (?:(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s*,\s*)?
264:           (\d{1,2})\s+
265:           (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s+
266:           (\d{2,})\s+
267:           (\d{2})\s*
268:           :\s*(\d{2})\s*
269:           (?::\s*(\d{2}))?\s+
270:           ([+-]\d{4}|
271:            UT|GMT|EST|EDT|CST|CDT|MST|MDT|PST|PDT|[A-IK-Z])/ix =~ date
272:         # Since RFC 2822 permit comments, the regexp has no right anchor.
273:         day = $1.to_i
274:         mon = MonthValue[$2.upcase]
275:         year = $3.to_i
276:         hour = $4.to_i
277:         min = $5.to_i
278:         sec = $6 ? $6.to_i : 0
279:         zone = $7
280: 
281:         # following year completion is compliant with RFC 2822.
282:         year = if year < 50
283:                  2000 + year
284:                elsif year < 1000
285:                  1900 + year
286:                else
287:                  year
288:                end
289: 
290:         year, mon, day, hour, min, sec =
291:           apply_offset(year, mon, day, hour, min, sec, zone_offset(zone))
292:         t = self.utc(year, mon, day, hour, min, sec)
293:         t.localtime if !zone_utc?(zone)
294:         t
295:       else
296:         raise ArgumentError.new("not RFC 2822 compliant date: #{date.inspect}")
297:       end
298:     end

Deprecated in favor of Process::times

[Source]

/*
 *  call-seq:
 *     Time.times => struct_tms
 *  
 *  Deprecated in favor of <code>Process::times</code>
 */

static VALUE
time_s_times(obj)
    VALUE obj;
{
    rb_warn("obsolete method Time::times; use Process::times");
    return rb_proc_times(obj);
}

Creates a time based on given values, interpreted as UTC (GMT). The year must be specified. Other values default to the minimum value for that field (and may be nil or omitted). Months may be specified by numbers from 1 to 12, or by the three-letter English month names. Hours are specified on a 24-hour clock (0..23). Raises an ArgumentError if any values are out of range. Will also accept ten arguments in the order output by Time#to_a.

   Time.utc(2000,"jan",1,20,15,1)  #=> Sat Jan 01 20:15:01 UTC 2000
   Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000

[Source]

/*
 *  call-seq:
 *     Time.utc( year [, month, day, hour, min, sec, usec] ) => time
 *     Time.utc( sec, min, hour, day, month, year, wday, yday, isdst, tz
 *     ) => time
 *     Time.gm( year [, month, day, hour, min, sec, usec] ) => time
 *     Time.gm( sec, min, hour, day, month, year, wday, yday, isdst, tz
 *     ) => time
 *     
 *  Creates a time based on given values, interpreted as UTC (GMT). The
 *  year must be specified. Other values default to the minimum value
 *  for that field (and may be <code>nil</code> or omitted). Months may
 *  be specified by numbers from 1 to 12, or by the three-letter English
 *  month names. Hours are specified on a 24-hour clock (0..23). Raises
 *  an <code>ArgumentError</code> if any values are out of range. Will
 *  also accept ten arguments in the order output by
 *  <code>Time#to_a</code>.
 *
 *     Time.utc(2000,"jan",1,20,15,1)  #=> Sat Jan 01 20:15:01 UTC 2000
 *     Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 */
static VALUE
time_s_mkutc(argc, argv, klass)
    int argc;
    VALUE *argv;
    VALUE klass;
{
    return time_utc_or_local(argc, argv, Qtrue, klass);
}

[Source]

    # File lib/rss/rss.rb, line 6
 6:       def w3cdtf(date)
 7:         if /\A\s*
 8:             (-?\d+)-(\d\d)-(\d\d)
 9:             (?:T
10:             (\d\d):(\d\d)(?::(\d\d))?
11:             (\.\d+)?
12:             (Z|[+-]\d\d:\d\d)?)?
13:             \s*\z/ix =~ date and (($5 and $8) or (!$5 and !$8))
14:           datetime = [$1.to_i, $2.to_i, $3.to_i, $4.to_i, $5.to_i, $6.to_i]
15:           usec = 0
16:           usec = $7.to_f * 1000000 if $7
17:           zone = $8
18:           if zone
19:             off = zone_offset(zone, datetime[0])
20:             datetime = apply_offset(*(datetime + [off]))
21:             datetime << usec
22:             time = Time.utc(*datetime)
23:             time.localtime unless zone_utc?(zone)
24:             time
25:           else
26:             datetime << usec
27:             Time.local(*datetime)
28:           end
29:         else
30:           raise ArgumentError.new("invalid date: #{date.inspect}")
31:         end
32:       end

Parses date as dateTime defined by XML Schema and converts it to a Time object. The format is restricted version of the format defined by ISO 8601.

ArgumentError is raised if date is not compliant with the format or Time class cannot represent specified date.

See xmlschema for more information on this format.

[Source]

     # File lib/time.rb, line 351
351:     def xmlschema(date)
352:       if /\A\s*
353:           (-?\d+)-(\d\d)-(\d\d)
354:           T
355:           (\d\d):(\d\d):(\d\d)
356:           (\.\d*)?
357:           (Z|[+-]\d\d:\d\d)?
358:           \s*\z/ix =~ date
359:         year = $1.to_i
360:         mon = $2.to_i
361:         day = $3.to_i
362:         hour = $4.to_i
363:         min = $5.to_i
364:         sec = $6.to_i
365:         usec = 0
366:         usec = ($7[1..-1] + '000000')[0,6].to_i if $7
367:         if $8
368:           zone = $8
369:           year, mon, day, hour, min, sec =
370:             apply_offset(year, mon, day, hour, min, sec, zone_offset(zone))
371:           self.utc(year, mon, day, hour, min, sec, usec)
372:         else
373:           self.local(year, mon, day, hour, min, sec, usec)
374:         end
375:       else
376:         raise ArgumentError.new("invalid date: #{date.inspect}")
377:       end
378:     end

[Source]

     # File lib/yaml/rubytypes.rb, line 303
303:     def Time.yaml_new( klass, tag, val )
304:         if Hash === val
305:             t = val.delete( 'at' )
306:             val.each { |k,v| t.instance_variable_set( k, v ) }
307:             t
308:         else
309:             raise YAML::TypeError, "Invalid Time: " + val.inspect
310:         end
311:     end

[Source]

    # File lib/time.rb, line 69
69:     def zone_offset(zone, year=self.now.year)
70:       off = nil
71:       zone = zone.upcase
72:       if /\A([+-])(\d\d):?(\d\d)\z/ =~ zone
73:         off = ($1 == '-' ? -1 : 1) * ($2.to_i * 60 + $3.to_i) * 60
74:       elsif /\A[+-]\d\d\z/ =~ zone
75:         off = zone.to_i * 3600
76:       elsif ZoneOffset.include?(zone)
77:         off = ZoneOffset[zone] * 3600
78:       elsif ((t = self.local(year, 1, 1)).zone.upcase == zone rescue false)
79:         off = t.utc_offset
80:       elsif ((t = self.local(year, 7, 1)).zone.upcase == zone rescue false)
81:         off = t.utc_offset
82:       end
83:       off
84:     end

Private Class methods

[Source]

     # File lib/time.rb, line 108
108:     def apply_offset(year, mon, day, hour, min, sec, off)
109:       if off < 0
110:         off = -off
111:         off, o = off.divmod(60)
112:         if o != 0 then sec += o; o, sec = sec.divmod(60); off += o end
113:         off, o = off.divmod(60)
114:         if o != 0 then min += o; o, min = min.divmod(60); off += o end
115:         off, o = off.divmod(24)
116:         if o != 0 then hour += o; o, hour = hour.divmod(24); off += o end
117:         if off != 0
118:           day += off
119:           if month_days(year, mon) < day
120:             mon += 1
121:             if 12 < mon
122:               mon = 1
123:               year += 1
124:             end
125:             day = 1
126:           end
127:         end
128:       elsif 0 < off
129:         off, o = off.divmod(60)
130:         if o != 0 then sec -= o; o, sec = sec.divmod(60); off -= o end
131:         off, o = off.divmod(60)
132:         if o != 0 then min -= o; o, min = min.divmod(60); off -= o end
133:         off, o = off.divmod(24)
134:         if o != 0 then hour -= o; o, hour = hour.divmod(24); off -= o end
135:         if off != 0 then
136:           day -= off
137:           if day < 1
138:             mon -= 1
139:             if mon < 1
140:               year -= 1
141:               mon = 12
142:             end
143:             day = month_days(year, mon)
144:           end
145:         end
146:       end
147:       return year, mon, day, hour, min, sec
148:     end

[Source]

     # File lib/time.rb, line 151
151:     def make_time(year, mon, day, hour, min, sec, sec_fraction, zone, now)
152:       usec = nil
153:       usec = (sec_fraction * 1000000).to_i if sec_fraction
154:       if now
155:         begin
156:           break if year; year = now.year
157:           break if mon; mon = now.mon
158:           break if day; day = now.day
159:           break if hour; hour = now.hour
160:           break if min; min = now.min
161:           break if sec; sec = now.sec
162:           break if sec_fraction; usec = now.tv_usec
163:         end until true
164:       end
165: 
166:       year ||= 1970
167:       mon ||= 1
168:       day ||= 1
169:       hour ||= 0
170:       min ||= 0
171:       sec ||= 0
172:       usec ||= 0
173: 
174:       off = nil
175:       off = zone_offset(zone, year) if zone
176: 
177:       if off
178:         year, mon, day, hour, min, sec =
179:           apply_offset(year, mon, day, hour, min, sec, off)
180:         t = self.utc(year, mon, day, hour, min, sec, usec)
181:         t.localtime if !zone_utc?(zone)
182:         t
183:       else
184:         self.local(year, mon, day, hour, min, sec, usec)
185:       end
186:     end

[Source]

     # File lib/time.rb, line 99
 99:     def month_days(y, m)
100:       if ((y % 4 == 0) && (y % 100 != 0)) || (y % 400 == 0)
101:         LeapYearMonthDays[m-1]
102:       else
103:         CommonYearMonthDays[m-1]
104:       end
105:     end

[Source]

    # File lib/time.rb, line 86
86:     def zone_utc?(zone)
87:       # * +0000 means localtime. [RFC 2822]
88:       # * GMT is a localtime abbreviation in Europe/London, etc.
89:       if /\A(?:-00:00|-0000|-00|UTC|Z|UT)\z/i =~ zone
90:         true
91:       else
92:         false
93:       end
94:     end

Public Instance methods

Addition—Adds some number of seconds (possibly fractional) to time and returns that value as a new time.

   t = Time.now         #=> Wed Apr 09 08:56:03 CDT 2003
   t + (60 * 60 * 24)   #=> Thu Apr 10 08:56:03 CDT 2003

[Source]

/*
 *  call-seq:
 *     time + numeric => time
 *  
 *  Addition---Adds some number of seconds (possibly fractional) to
 *  <i>time</i> and returns that value as a new time.
 *     
 *     t = Time.now         #=> Wed Apr 09 08:56:03 CDT 2003
 *     t + (60 * 60 * 24)   #=> Thu Apr 10 08:56:03 CDT 2003
 */

static VALUE
time_plus(time1, time2)
    VALUE time1, time2;
{
    struct time_object *tobj;
    GetTimeval(time1, tobj);

    if (TYPE(time2) == T_DATA && RDATA(time2)->dfree == time_free) {
        rb_raise(rb_eTypeError, "time + time?");
    }
    return time_add(tobj, time2, 1);
}

Difference—Returns a new time that represents the difference between two times, or subtracts the given number of seconds in numeric from time.

   t = Time.now       #=> Wed Apr 09 08:56:03 CDT 2003
   t2 = t + 2592000   #=> Fri May 09 08:56:03 CDT 2003
   t2 - t             #=> 2592000.0
   t2 - 2592000       #=> Wed Apr 09 08:56:03 CDT 2003

[Source]

/*
 *  call-seq:
 *     time - other_time => float
 *     time - numeric    => time
 *  
 *  Difference---Returns a new time that represents the difference
 *  between two times, or subtracts the given number of seconds in
 *  <i>numeric</i> from <i>time</i>.
 *     
 *     t = Time.now       #=> Wed Apr 09 08:56:03 CDT 2003
 *     t2 = t + 2592000   #=> Fri May 09 08:56:03 CDT 2003
 *     t2 - t             #=> 2592000.0
 *     t2 - 2592000       #=> Wed Apr 09 08:56:03 CDT 2003
 */

static VALUE
time_minus(time1, time2)
    VALUE time1, time2;
{
    struct time_object *tobj;

    GetTimeval(time1, tobj);
    if (TYPE(time2) == T_DATA && RDATA(time2)->dfree == time_free) {
        struct time_object *tobj2;
        double f;

        GetTimeval(time2, tobj2);
        f = (double)tobj->tv.tv_sec - (double)tobj2->tv.tv_sec;
        f += ((double)tobj->tv.tv_usec - (double)tobj2->tv.tv_usec)*1e-6;
        /* XXX: should check float overflow on 64bit time_t platforms */

        return rb_float_new(f);
    }
    return time_add(tobj, time2, -1);
}

Comparison—Compares time with other_time or with numeric, which is the number of seconds (possibly fractional) since epoch.

   t = Time.now       #=> Wed Apr 09 08:56:03 CDT 2003
   t2 = t + 2592000   #=> Fri May 09 08:56:03 CDT 2003
   t <=> t2           #=> -1
   t2 <=> t           #=> 1
   t <=> t            #=> 0

[Source]

/*
 *  call-seq:
 *     time <=> other_time => -1, 0, +1 
 *     time <=> numeric    => -1, 0, +1
 *  
 *  Comparison---Compares <i>time</i> with <i>other_time</i> or with
 *  <i>numeric</i>, which is the number of seconds (possibly
 *  fractional) since epoch.
 *     
 *     t = Time.now       #=> Wed Apr 09 08:56:03 CDT 2003
 *     t2 = t + 2592000   #=> Fri May 09 08:56:03 CDT 2003
 *     t <=> t2           #=> -1
 *     t2 <=> t           #=> 1
 *     t <=> t            #=> 0
 */

static VALUE
time_cmp(time1, time2)
    VALUE time1, time2;
{
    struct time_object *tobj1, *tobj2;

    GetTimeval(time1, tobj1);
    if (TYPE(time2) == T_DATA && RDATA(time2)->dfree == time_free) {
        GetTimeval(time2, tobj2);
        if (tobj1->tv.tv_sec == tobj2->tv.tv_sec) {
            if (tobj1->tv.tv_usec == tobj2->tv.tv_usec) return INT2FIX(0);
            if (tobj1->tv.tv_usec > tobj2->tv.tv_usec) return INT2FIX(1);
            return INT2FIX(-1);
        }
        if (tobj1->tv.tv_sec > tobj2->tv.tv_sec) return INT2FIX(1);
        return INT2FIX(-1);
    }

    return Qnil;
}

Dump time for marshaling.

[Source]

/*
 * call-seq:
 *   time._dump   => string
 *
 * Dump _time_ for marshaling.
 */

static VALUE
time_dump(argc, argv, time)
    int argc;
    VALUE *argv;
    VALUE time;
{
    VALUE str;

    rb_scan_args(argc, argv, "01", 0);
    str = time_mdump(time); 
    if (FL_TEST(time, FL_EXIVAR)) {
        rb_copy_generic_ivar(str, time);
        FL_SET(str, FL_EXIVAR);
    }

    return str;
}

Returns a canonical string representation of time.

   Time.now.asctime   #=> "Wed Apr  9 08:56:03 2003"

[Source]

/*
 *  call-seq:
 *     time.asctime => string
 *     time.ctime   => string
 *  
 *  Returns a canonical string representation of <i>time</i>.
 *     
 *     Time.now.asctime   #=> "Wed Apr  9 08:56:03 2003"
 */

static VALUE
time_asctime(time)
    VALUE time;
{
    struct time_object *tobj;
    char *s;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    s = asctime(&tobj->tm);
    if (s[24] == '\n') s[24] = '\0';

    return rb_str_new2(s);
}

Returns a canonical string representation of time.

   Time.now.asctime   #=> "Wed Apr  9 08:56:03 2003"

[Source]

/*
 *  call-seq:
 *     time.asctime => string
 *     time.ctime   => string
 *  
 *  Returns a canonical string representation of <i>time</i>.
 *     
 *     Time.now.asctime   #=> "Wed Apr  9 08:56:03 2003"
 */

static VALUE
time_asctime(time)
    VALUE time;
{
    struct time_object *tobj;
    char *s;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    s = asctime(&tobj->tm);
    if (s[24] == '\n') s[24] = '\0';

    return rb_str_new2(s);
}

Returns the day of the month (1..n) for time.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.day          #=> 9
   t.mday         #=> 9

[Source]

/*
 *  call-seq:
 *     time.day  => fixnum
 *     time.mday => fixnum
 *  
 *  Returns the day of the month (1..n) for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.day          #=> 9
 *     t.mday         #=> 9
 */

static VALUE
time_mday(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_mday);
}

Returns true if time occurs during Daylight Saving Time in its time zone.

   Time.local(2000, 7, 1).isdst   #=> true
   Time.local(2000, 1, 1).isdst   #=> false
   Time.local(2000, 7, 1).dst?    #=> true
   Time.local(2000, 1, 1).dst?    #=> false

[Source]

/*
 *  call-seq:
 *     time.isdst => true or false
 *     time.dst?  => true or false
 *  
 *  Returns <code>true</code> if <i>time</i> occurs during Daylight
 *  Saving Time in its time zone.
 *     
 *     Time.local(2000, 7, 1).isdst   #=> true
 *     Time.local(2000, 1, 1).isdst   #=> false
 *     Time.local(2000, 7, 1).dst?    #=> true
 *     Time.local(2000, 1, 1).dst?    #=> false
 */

static VALUE
time_isdst(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return tobj->tm.tm_isdst?Qtrue:Qfalse;
}

Return true if time and other_time are both Time objects with the same seconds and fractional seconds.

[Source]

/*
 * call-seq:
 *  time.eql?(other_time)
 *
 * Return <code>true</code> if <i>time</i> and <i>other_time</i> are
 * both <code>Time</code> objects with the same seconds and fractional
 * seconds.
 */

static VALUE
time_eql(time1, time2)
    VALUE time1, time2;
{
    struct time_object *tobj1, *tobj2;

    GetTimeval(time1, tobj1);
    if (TYPE(time2) == T_DATA && RDATA(time2)->dfree == time_free) {
        GetTimeval(time2, tobj2);
        if (tobj1->tv.tv_sec == tobj2->tv.tv_sec) {
            if (tobj1->tv.tv_usec == tobj2->tv.tv_usec) return Qtrue;
        }
    }
    return Qfalse;
}

Returns a new new_time object representing time in UTC.

   t = Time.local(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000
   t.gmt?                             #=> false
   y = t.getgm                        #=> Sun Jan 02 02:15:01 UTC 2000
   y.gmt?                             #=> true
   t == y                             #=> true

[Source]

/*
 *  call-seq:
 *     time.getgm  => new_time
 *     time.getutc => new_time
 *  
 *  Returns a new <code>new_time</code> object representing <i>time</i> in
 *  UTC.
 *     
 *     t = Time.local(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000
 *     t.gmt?                             #=> false
 *     y = t.getgm                        #=> Sun Jan 02 02:15:01 UTC 2000
 *     y.gmt?                             #=> true
 *     t == y                             #=> true
 */

static VALUE
time_getgmtime(time)
    VALUE time;
{
    return time_gmtime(time_dup(time));
}

Returns a new new_time object representing time in local time (using the local time zone in effect for this process).

   t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
   t.gmt?                          #=> true
   l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
   l.gmt?                          #=> false
   t == l                          #=> true

[Source]

/*
 *  call-seq:
 *     time.getlocal => new_time
 *  
 *  Returns a new <code>new_time</code> object representing <i>time</i> in
 *  local time (using the local time zone in effect for this process).
 *     
 *     t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.gmt?                          #=> true
 *     l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
 *     l.gmt?                          #=> false
 *     t == l                          #=> true
 */

static VALUE
time_getlocaltime(time)
    VALUE time;
{
    return time_localtime(time_dup(time));
}

Returns a new new_time object representing time in UTC.

   t = Time.local(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000
   t.gmt?                             #=> false
   y = t.getgm                        #=> Sun Jan 02 02:15:01 UTC 2000
   y.gmt?                             #=> true
   t == y                             #=> true

[Source]

/*
 *  call-seq:
 *     time.getgm  => new_time
 *     time.getutc => new_time
 *  
 *  Returns a new <code>new_time</code> object representing <i>time</i> in
 *  UTC.
 *     
 *     t = Time.local(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 CST 2000
 *     t.gmt?                             #=> false
 *     y = t.getgm                        #=> Sun Jan 02 02:15:01 UTC 2000
 *     y.gmt?                             #=> true
 *     t == y                             #=> true
 */

static VALUE
time_getgmtime(time)
    VALUE time;
{
    return time_gmtime(time_dup(time));
}

Returns true if time represents a time in UTC (GMT).

   t = Time.now                        #=> Wed Apr 09 08:56:04 CDT 2003
   t.utc?                              #=> false
   t = Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
   t.utc?                              #=> true

   t = Time.now                        #=> Wed Apr 09 08:56:03 CDT 2003
   t.gmt?                              #=> false
   t = Time.gm(2000,1,1,20,15,1)       #=> Sat Jan 01 20:15:01 UTC 2000
   t.gmt?                              #=> true

[Source]

/*
 *  call-seq:
 *     time.utc? => true or false
 *     time.gmt? => true or false
 *  
 *  Returns <code>true</code> if <i>time</i> represents a time in UTC
 *  (GMT).
 *     
 *     t = Time.now                        #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.utc?                              #=> false
 *     t = Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.utc?                              #=> true
 *
 *     t = Time.now                        #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.gmt?                              #=> false
 *     t = Time.gm(2000,1,1,20,15,1)       #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.gmt?                              #=> true
 */

static VALUE
time_utc_p(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->gmt) return Qtrue;
    return Qfalse;
}

Returns the offset in seconds between the timezone of time and UTC.

   t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
   t.gmt_offset                    #=> 0
   l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
   l.gmt_offset                    #=> -21600

[Source]

/*
 *  call-seq:
 *     time.gmt_offset => fixnum
 *     time.gmtoff     => fixnum
 *     time.utc_offset => fixnum
 *  
 *  Returns the offset in seconds between the timezone of <i>time</i>
 *  and UTC.
 *     
 *     t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.gmt_offset                    #=> 0
 *     l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
 *     l.gmt_offset                    #=> -21600
 */

static VALUE
time_utc_offset(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }

    if (tobj->gmt == 1) {
        return INT2FIX(0);
    }
    else {
#if defined(HAVE_STRUCT_TM_TM_GMTOFF)
        return INT2NUM(tobj->tm.tm_gmtoff);
#else
        struct tm *u, *l;
        time_t t;
        long off;
        l = &tobj->tm;
        t = tobj->tv.tv_sec;
        u = gmtime(&t);
        if (!u)
            rb_raise(rb_eArgError, "gmtime error");
        if (l->tm_year != u->tm_year)
            off = l->tm_year < u->tm_year ? -1 : 1;
        else if (l->tm_mon != u->tm_mon)
            off = l->tm_mon < u->tm_mon ? -1 : 1;
        else if (l->tm_mday != u->tm_mday)
            off = l->tm_mday < u->tm_mday ? -1 : 1;
        else
            off = 0;
        off = off * 24 + l->tm_hour - u->tm_hour;
        off = off * 60 + l->tm_min - u->tm_min;
        off = off * 60 + l->tm_sec - u->tm_sec;
        return LONG2FIX(off);
#endif
    }
}

Converts time to UTC (GMT), modifying the receiver.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.gmt?         #=> false
   t.gmtime       #=> Wed Apr 09 13:56:03 UTC 2003
   t.gmt?         #=> true

   t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t.utc?         #=> false
   t.utc          #=> Wed Apr 09 13:56:04 UTC 2003
   t.utc?         #=> true

[Source]

/*
 *  call-seq:
 *     time.gmtime    => time
 *     time.utc       => time
 *  
 *  Converts <i>time</i> to UTC (GMT), modifying the receiver.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.gmt?         #=> false
 *     t.gmtime       #=> Wed Apr 09 13:56:03 UTC 2003
 *     t.gmt?         #=> true
 *
 *     t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.utc?         #=> false
 *     t.utc          #=> Wed Apr 09 13:56:04 UTC 2003
 *     t.utc?         #=> true
 */

static VALUE
time_gmtime(time)
    VALUE time;
{
    struct time_object *tobj;
    struct tm *tm_tmp;
    time_t t;

    GetTimeval(time, tobj);
    if (tobj->gmt) {
        if (tobj->tm_got)
            return time;
    }
    else {
        time_modify(time);
    }
    t = tobj->tv.tv_sec;
    tm_tmp = gmtime(&t);
    if (!tm_tmp)
        rb_raise(rb_eArgError, "gmtime error");
    tobj->tm = *tm_tmp;
    tobj->tm_got = 1;
    tobj->gmt = 1;
    return time;
}

Returns the offset in seconds between the timezone of time and UTC.

   t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
   t.gmt_offset                    #=> 0
   l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
   l.gmt_offset                    #=> -21600

[Source]

/*
 *  call-seq:
 *     time.gmt_offset => fixnum
 *     time.gmtoff     => fixnum
 *     time.utc_offset => fixnum
 *  
 *  Returns the offset in seconds between the timezone of <i>time</i>
 *  and UTC.
 *     
 *     t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.gmt_offset                    #=> 0
 *     l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
 *     l.gmt_offset                    #=> -21600
 */

static VALUE
time_utc_offset(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }

    if (tobj->gmt == 1) {
        return INT2FIX(0);
    }
    else {
#if defined(HAVE_STRUCT_TM_TM_GMTOFF)
        return INT2NUM(tobj->tm.tm_gmtoff);
#else
        struct tm *u, *l;
        time_t t;
        long off;
        l = &tobj->tm;
        t = tobj->tv.tv_sec;
        u = gmtime(&t);
        if (!u)
            rb_raise(rb_eArgError, "gmtime error");
        if (l->tm_year != u->tm_year)
            off = l->tm_year < u->tm_year ? -1 : 1;
        else if (l->tm_mon != u->tm_mon)
            off = l->tm_mon < u->tm_mon ? -1 : 1;
        else if (l->tm_mday != u->tm_mday)
            off = l->tm_mday < u->tm_mday ? -1 : 1;
        else
            off = 0;
        off = off * 24 + l->tm_hour - u->tm_hour;
        off = off * 60 + l->tm_min - u->tm_min;
        off = off * 60 + l->tm_sec - u->tm_sec;
        return LONG2FIX(off);
#endif
    }
}

Return a hash code for this time object.

[Source]

/*
 * call-seq:
 *   time.hash   => fixnum
 *
 * Return a hash code for this time object.
 */

static VALUE
time_hash(time)
    VALUE time;
{
    struct time_object *tobj;
    long hash;

    GetTimeval(time, tobj);
    hash = tobj->tv.tv_sec ^ tobj->tv.tv_usec;
    return LONG2FIX(hash);
}

Returns the hour of the day (0..23) for time.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.hour         #=> 8

[Source]

/*
 *  call-seq:
 *     time.hour => fixnum
 *  
 *  Returns the hour of the day (0..23) for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.hour         #=> 8
 */

static VALUE
time_hour(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_hour);
}

Returns a string which represents the time as rfc1123-date of HTTP-date defined by RFC 2616:

  day-of-week, DD month-name CCYY hh:mm:ss GMT

Note that the result is always UTC (GMT).

[Source]

     # File lib/time.rb, line 422
422:   def httpdate
423:     t = dup.utc
424:     sprintf('%s, %02d %s %d %02d:%02d:%02d GMT',
425:       RFC2822_DAY_NAME[t.wday],
426:       t.day, RFC2822_MONTH_NAME[t.mon-1], t.year,
427:       t.hour, t.min, t.sec)
428:   end

Returns a string representing time. Equivalent to calling Time#strftime with a format string of ``%a %b %d %H:%M:%S %Z %Y’’.

   Time.now.to_s   #=> "Wed Apr 09 08:56:04 CDT 2003"

[Source]

/*
 *  call-seq:
 *     time.inspect => string
 *     time.to_s    => string
 *  
 *  Returns a string representing <i>time</i>. Equivalent to calling
 *  <code>Time#strftime</code> with a format string of ``<code>%a</code>
 *  <code>%b</code> <code>%d</code> <code>%H:%M:%S</code>
 *  <code>%Z</code> <code>%Y</code>''.
 *     
 *     Time.now.to_s   #=> "Wed Apr 09 08:56:04 CDT 2003"
 */

static VALUE
time_to_s(time)
    VALUE time;
{
    struct time_object *tobj;
    char buf[128];
    int len;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    if (tobj->gmt == 1) {
        len = strftime(buf, 128, "%a %b %d %H:%M:%S UTC %Y", &tobj->tm);
    }
    else {
        time_t off;
        char buf2[32];
        char sign = '+';
#if defined(HAVE_STRUCT_TM_TM_GMTOFF)
        off = tobj->tm.tm_gmtoff;
#else
        VALUE tmp = time_utc_offset(time);
        off = NUM2INT(tmp);
#endif
        if (off < 0) {
            sign = '-';
            off = -off;
        }
        sprintf(buf2, "%%a %%b %%d %%H:%%M:%%S %c%02d%02d %%Y",
                sign, (int)(off/3600), (int)(off%3600/60));
        len = strftime(buf, 128, buf2, &tobj->tm);
    }
    return rb_str_new(buf, len);
}

Returns true if time occurs during Daylight Saving Time in its time zone.

   Time.local(2000, 7, 1).isdst   #=> true
   Time.local(2000, 1, 1).isdst   #=> false
   Time.local(2000, 7, 1).dst?    #=> true
   Time.local(2000, 1, 1).dst?    #=> false

[Source]

/*
 *  call-seq:
 *     time.isdst => true or false
 *     time.dst?  => true or false
 *  
 *  Returns <code>true</code> if <i>time</i> occurs during Daylight
 *  Saving Time in its time zone.
 *     
 *     Time.local(2000, 7, 1).isdst   #=> true
 *     Time.local(2000, 1, 1).isdst   #=> false
 *     Time.local(2000, 7, 1).dst?    #=> true
 *     Time.local(2000, 1, 1).dst?    #=> false
 */

static VALUE
time_isdst(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return tobj->tm.tm_isdst?Qtrue:Qfalse;
}
iso8601(fraction_digits=0)

Alias for xmlschema

Converts time to local time (using the local time zone in effect for this process) modifying the receiver.

   t = Time.gm(2000, "jan", 1, 20, 15, 1)
   t.gmt?        #=> true
   t.localtime   #=> Sat Jan 01 14:15:01 CST 2000
   t.gmt?        #=> false

[Source]

/*
 *  call-seq:
 *     time.localtime => time
 *  
 *  Converts <i>time</i> to local time (using the local time zone in
 *  effect for this process) modifying the receiver.
 *     
 *     t = Time.gm(2000, "jan", 1, 20, 15, 1)
 *     t.gmt?        #=> true
 *     t.localtime   #=> Sat Jan 01 14:15:01 CST 2000
 *     t.gmt?        #=> false
 */

static VALUE
time_localtime(time)
    VALUE time;
{
    struct time_object *tobj;
    struct tm *tm_tmp;
    time_t t;

    GetTimeval(time, tobj);
    if (!tobj->gmt) {
        if (tobj->tm_got)
            return time;
    }
    else {
        time_modify(time);
    }
    t = tobj->tv.tv_sec;
    tm_tmp = localtime(&t);
    if (!tm_tmp)
        rb_raise(rb_eArgError, "localtime error");
    tobj->tm = *tm_tmp;
    tobj->tm_got = 1;
    tobj->gmt = 0;
    return time;
}

undocumented

[Source]

/*
 * undocumented
 */

static VALUE
time_mdump(time)
    VALUE time;
{
    struct time_object *tobj;
    struct tm *tm;
    unsigned long p, s;
    char buf[8];
    time_t t;
    int i;

    GetTimeval(time, tobj);

    t = tobj->tv.tv_sec;
    tm = gmtime(&t);

    if ((tm->tm_year & 0xffff) != tm->tm_year)
        rb_raise(rb_eArgError, "year too big to marshal");

    p = 0x1UL        << 31 | /*  1 */
        tobj->gmt    << 30 | /*  1 */
        tm->tm_year  << 14 | /* 16 */
        tm->tm_mon   << 10 | /*  4 */
        tm->tm_mday  <<  5 | /*  5 */
        tm->tm_hour;         /*  5 */
    s = tm->tm_min   << 26 | /*  6 */
        tm->tm_sec   << 20 | /*  6 */
        tobj->tv.tv_usec;    /* 20 */

    for (i=0; i<4; i++) {
        buf[i] = p & 0xff;
        p = RSHIFT(p, 8);
    }
    for (i=4; i<8; i++) {
        buf[i] = s & 0xff;
        s = RSHIFT(s, 8);
    }

    return rb_str_new(buf, 8);
}

undocumented

[Source]

/*
 * undocumented
 */

static VALUE
time_mload(time, str)
    VALUE time, str;
{
    struct time_object *tobj;
    unsigned long p, s;
    time_t sec, usec;
    unsigned char *buf;
    struct tm tm;
    int i, gmt;

    time_modify(time);
    StringValue(str);
    buf = (unsigned char *)RSTRING(str)->ptr;
    if (RSTRING(str)->len != 8) {
        rb_raise(rb_eTypeError, "marshaled time format differ");
    }

    p = s = 0;
    for (i=0; i<4; i++) {
        p |= buf[i]<<(8*i);
    }
    for (i=4; i<8; i++) {
        s |= buf[i]<<(8*(i-4));
    }

    if ((p & (1UL<<31)) == 0) {
        sec = p;
        usec = s;
    }
    else {
        p &= ~(1UL<<31);
        gmt        = (p >> 30) & 0x1;
        tm.tm_year = (p >> 14) & 0xffff;
        tm.tm_mon  = (p >> 10) & 0xf;
        tm.tm_mday = (p >>  5) & 0x1f;
        tm.tm_hour =  p        & 0x1f;
        tm.tm_min  = (s >> 26) & 0x3f;
        tm.tm_sec  = (s >> 20) & 0x3f;
        tm.tm_isdst = 0;

        sec = make_time_t(&tm, Qtrue);
        usec = (time_t)(s & 0xfffff);
    }
    time_overflow_p(&sec, &usec);

    GetTimeval(time, tobj);
    tobj->tm_got = 0;
    tobj->gmt = gmt;
    tobj->tv.tv_sec = sec;
    tobj->tv.tv_usec = usec;
    return time;
}

Returns the day of the month (1..n) for time.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.day          #=> 9
   t.mday         #=> 9

[Source]

/*
 *  call-seq:
 *     time.day  => fixnum
 *     time.mday => fixnum
 *  
 *  Returns the day of the month (1..n) for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.day          #=> 9
 *     t.mday         #=> 9
 */

static VALUE
time_mday(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_mday);
}

Returns the minute of the hour (0..59) for time.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.min          #=> 56

[Source]

/*
 *  call-seq:
 *     time.min => fixnum
 *  
 *  Returns the minute of the hour (0..59) for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.min          #=> 56
 */

static VALUE
time_min(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_min);
}

Returns the month of the year (1..12) for time.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.mon          #=> 4
   t.month        #=> 4

[Source]

/*
 *  call-seq:
 *     time.mon   => fixnum
 *     time.month => fixnum
 *  
 *  Returns the month of the year (1..12) for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.mon          #=> 4
 *     t.month        #=> 4
 */

static VALUE
time_mon(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_mon+1);
}

Returns the month of the year (1..12) for time.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.mon          #=> 4
   t.month        #=> 4

[Source]

/*
 *  call-seq:
 *     time.mon   => fixnum
 *     time.month => fixnum
 *  
 *  Returns the month of the year (1..12) for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.mon          #=> 4
 *     t.month        #=> 4
 */

static VALUE
time_mon(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_mon+1);
}

Returns a string which represents the time as date-time defined by RFC 2822:

  day-of-week, DD month-name CCYY hh:mm:ss zone

where zone is [+-]hhmm.

If self is a UTC time, -0000 is used as zone.

[Source]

     # File lib/time.rb, line 391
391:   def rfc2822
392:     sprintf('%s, %02d %s %d %02d:%02d:%02d ',
393:       RFC2822_DAY_NAME[wday],
394:       day, RFC2822_MONTH_NAME[mon-1], year,
395:       hour, min, sec) +
396:     if utc?
397:       '-0000'
398:     else
399:       off = utc_offset
400:       sign = off < 0 ? '-' : '+'
401:       sprintf('%s%02d%02d', sign, *(off.abs / 60).divmod(60))
402:     end
403:   end
rfc822()

Alias for rfc2822

Returns the second of the minute (0..60)[Yes, seconds really can range from zero to 60. This allows the system to inject leap seconds every now and then to correct for the fact that years are not really a convenient number of hours long.] for time.

   t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t.sec          #=> 4

[Source]

/*
 *  call-seq:
 *     time.sec => fixnum
 *  
 *  Returns the second of the minute (0..60)<em>[Yes, seconds really can
 *  range from zero to 60. This allows the system to inject leap seconds
 *  every now and then to correct for the fact that years are not really
 *  a convenient number of hours long.]</em> for <i>time</i>.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.sec          #=> 4
 */

static VALUE
time_sec(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_sec);
}

Formats time according to the directives in the given format string. Any text not listed as a directive will be passed through to the output string.

Format meaning:

  %a - The abbreviated weekday name (``Sun'')
  %A - The  full  weekday  name (``Sunday'')
  %b - The abbreviated month name (``Jan'')
  %B - The  full  month  name (``January'')
  %c - The preferred local date and time representation
  %d - Day of the month (01..31)
  %H - Hour of the day, 24-hour clock (00..23)
  %I - Hour of the day, 12-hour clock (01..12)
  %j - Day of the year (001..366)
  %m - Month of the year (01..12)
  %M - Minute of the hour (00..59)
  %p - Meridian indicator (``AM''  or  ``PM'')
  %S - Second of the minute (00..60)
  %U - Week  number  of the current year,
          starting with the first Sunday as the first
          day of the first week (00..53)
  %W - Week  number  of the current year,
          starting with the first Monday as the first
          day of the first week (00..53)
  %w - Day of the week (Sunday is 0, 0..6)
  %x - Preferred representation for the date alone, no time
  %X - Preferred representation for the time alone, no date
  %y - Year without a century (00..99)
  %Y - Year with century
  %Z - Time zone name
  %% - Literal ``%'' character

   t = Time.now
   t.strftime("Printed on %m/%d/%Y")   #=> "Printed on 04/09/2003"
   t.strftime("at %I:%M%p")            #=> "at 08:56AM"

[Source]

/*
 *  call-seq:
 *     time.strftime( string ) => string
 *  
 *  Formats <i>time</i> according to the directives in the given format
 *  string. Any text not listed as a directive will be passed through
 *  to the output string.
 *
 *  Format meaning:
 *    %a - The abbreviated weekday name (``Sun'')
 *    %A - The  full  weekday  name (``Sunday'')
 *    %b - The abbreviated month name (``Jan'')
 *    %B - The  full  month  name (``January'')
 *    %c - The preferred local date and time representation
 *    %d - Day of the month (01..31)
 *    %H - Hour of the day, 24-hour clock (00..23)
 *    %I - Hour of the day, 12-hour clock (01..12)
 *    %j - Day of the year (001..366)
 *    %m - Month of the year (01..12)
 *    %M - Minute of the hour (00..59)
 *    %p - Meridian indicator (``AM''  or  ``PM'')
 *    %S - Second of the minute (00..60)
 *    %U - Week  number  of the current year,
 *            starting with the first Sunday as the first
 *            day of the first week (00..53)
 *    %W - Week  number  of the current year,
 *            starting with the first Monday as the first
 *            day of the first week (00..53)
 *    %w - Day of the week (Sunday is 0, 0..6)
 *    %x - Preferred representation for the date alone, no time
 *    %X - Preferred representation for the time alone, no date
 *    %y - Year without a century (00..99)
 *    %Y - Year with century
 *    %Z - Time zone name
 *    %% - Literal ``%'' character
 *     
 *     t = Time.now
 *     t.strftime("Printed on %m/%d/%Y")   #=> "Printed on 04/09/2003"
 *     t.strftime("at %I:%M%p")            #=> "at 08:56AM"
 */

static VALUE
time_strftime(time, format)
    VALUE time, format;
{
    struct time_object *tobj;
    char buffer[SMALLBUF], *buf = buffer;
    const char *fmt;
    long len;
    VALUE str;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    StringValue(format);
    format = rb_str_new4(format);
    fmt = RSTRING(format)->ptr;
    len = RSTRING(format)->len;
    if (len == 0) {
        rb_warning("strftime called with empty format string");
    }
    else if (strlen(fmt) < len) {
        /* Ruby string may contain \0's. */
        const char *p = fmt, *pe = fmt + len;

        str = rb_str_new(0, 0);
        while (p < pe) {
            len = rb_strftime(&buf, p, &tobj->tm);
            rb_str_cat(str, buf, len);
            p += strlen(p);
            if (buf != buffer) {
                free(buf);
                buf = buffer;
            }
            for (fmt = p; p < pe && !*p; ++p);
            if (p > fmt) rb_str_cat(str, fmt, p - fmt);
        }
        return str;
    }
    else {
        len = rb_strftime(&buf, RSTRING(format)->ptr, &tobj->tm);
    }
    str = rb_str_new(buf, len);
    if (buf != buffer) free(buf);
    return str;
}

Return a new time object, one second later than time.

[Source]

/*
 * call-seq:
 *   time.succ   => new_time
 *
 * Return a new time object, one second later than <code>time</code>.
 */

static VALUE
time_succ(time)
    VALUE time;
{
    struct time_object *tobj;
    int gmt;

    GetTimeval(time, tobj);
    gmt = tobj->gmt;
    time = rb_time_new(tobj->tv.tv_sec + 1, tobj->tv.tv_usec);
    GetTimeval(time, tobj);
    tobj->gmt = gmt;
    return time;
}

Returns a ten-element array of values for time: {[ sec, min, hour, day, month, year, wday, yday, isdst, zone ]}. See the individual methods for an explanation of the valid ranges of each value. The ten elements can be passed directly to Time::utc or Time::local to create a new Time.

   now = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t = now.to_a     #=> [4, 56, 8, 9, 4, 2003, 3, 99, true, "CDT"]

[Source]

/*
 *  call-seq:
 *     time.to_a => array
 *  
 *  Returns a ten-element <i>array</i> of values for <i>time</i>:
 *  {<code>[ sec, min, hour, day, month, year, wday, yday, isdst, zone
 *  ]</code>}. See the individual methods for an explanation of the
 *  valid ranges of each value. The ten elements can be passed directly
 *  to <code>Time::utc</code> or <code>Time::local</code> to create a
 *  new <code>Time</code>.
 *     
 *     now = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t = now.to_a     #=> [4, 56, 8, 9, 4, 2003, 3, 99, true, "CDT"]
 */

static VALUE
time_to_a(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return rb_ary_new3(10,
                    INT2FIX(tobj->tm.tm_sec),
                    INT2FIX(tobj->tm.tm_min),
                    INT2FIX(tobj->tm.tm_hour),
                    INT2FIX(tobj->tm.tm_mday),
                    INT2FIX(tobj->tm.tm_mon+1),
                    LONG2NUM((long)tobj->tm.tm_year+1900),
                    INT2FIX(tobj->tm.tm_wday),
                    INT2FIX(tobj->tm.tm_yday+1),
                    tobj->tm.tm_isdst?Qtrue:Qfalse,
                    time_zone(time));
}

def to_time() getlocal end

[Source]

      # File lib/date.rb, line 1639
1639:   def to_date
1640:     jd = Date.civil_to_jd(year, mon, mday, Date::ITALY)
1641:     Date.new!(Date.jd_to_ajd(jd, 0, 0), 0, Date::ITALY)
1642:   end

[Source]

      # File lib/date.rb, line 1644
1644:   def to_datetime
1645:     jd = DateTime.civil_to_jd(year, mon, mday, DateTime::ITALY)
1646:     fr = DateTime.time_to_day_fraction(hour, min, [sec, 59].min) +
1647:       Rational(usec, 86400_000_000)
1648:     of = Rational(utc_offset, 86400)
1649:     DateTime.new!(DateTime.jd_to_ajd(jd, fr, of), of, DateTime::ITALY)
1650:   end

Returns the value of time as a floating point number of seconds since epoch.

   t = Time.now
   "%10.5f" % t.to_f   #=> "1049896564.13654"
   t.to_i              #=> 1049896564

[Source]

/*
 *  call-seq:
 *     time.to_f => float
 *  
 *  Returns the value of <i>time</i> as a floating point number of
 *  seconds since epoch.
 *     
 *     t = Time.now
 *     "%10.5f" % t.to_f   #=> "1049896564.13654"
 *     t.to_i              #=> 1049896564
 */

static VALUE
time_to_f(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    return rb_float_new((double)tobj->tv.tv_sec+(double)tobj->tv.tv_usec/1e6);
}

Returns the value of time as an integer number of seconds since epoch.

   t = Time.now
   "%10.5f" % t.to_f   #=> "1049896564.17839"
   t.to_i              #=> 1049896564

[Source]

/*
 *  call-seq:
 *     time.to_i   => int
 *     time.tv_sec => int
 *  
 *  Returns the value of <i>time</i> as an integer number of seconds
 *  since epoch.
 *     
 *     t = Time.now
 *     "%10.5f" % t.to_f   #=> "1049896564.17839"
 *     t.to_i              #=> 1049896564
 */

static VALUE
time_to_i(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    return LONG2NUM(tobj->tv.tv_sec);
}

Returns a string representing time. Equivalent to calling Time#strftime with a format string of ``%a %b %d %H:%M:%S %Z %Y’’.

   Time.now.to_s   #=> "Wed Apr 09 08:56:04 CDT 2003"

[Source]

/*
 *  call-seq:
 *     time.inspect => string
 *     time.to_s    => string
 *  
 *  Returns a string representing <i>time</i>. Equivalent to calling
 *  <code>Time#strftime</code> with a format string of ``<code>%a</code>
 *  <code>%b</code> <code>%d</code> <code>%H:%M:%S</code>
 *  <code>%Z</code> <code>%Y</code>''.
 *     
 *     Time.now.to_s   #=> "Wed Apr 09 08:56:04 CDT 2003"
 */

static VALUE
time_to_s(time)
    VALUE time;
{
    struct time_object *tobj;
    char buf[128];
    int len;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    if (tobj->gmt == 1) {
        len = strftime(buf, 128, "%a %b %d %H:%M:%S UTC %Y", &tobj->tm);
    }
    else {
        time_t off;
        char buf2[32];
        char sign = '+';
#if defined(HAVE_STRUCT_TM_TM_GMTOFF)
        off = tobj->tm.tm_gmtoff;
#else
        VALUE tmp = time_utc_offset(time);
        off = NUM2INT(tmp);
#endif
        if (off < 0) {
            sign = '-';
            off = -off;
        }
        sprintf(buf2, "%%a %%b %%d %%H:%%M:%%S %c%02d%02d %%Y",
                sign, (int)(off/3600), (int)(off%3600/60));
        len = strftime(buf, 128, buf2, &tobj->tm);
    }
    return rb_str_new(buf, len);
}

[Source]

     # File lib/yaml/rubytypes.rb, line 312
312:         def to_yaml( opts = {} )
313:                 YAML::quick_emit( self, opts ) do |out|
314:             tz = "Z"
315:             # from the tidy Tobias Peters <t-peters@gmx.de> Thanks!
316:             unless self.utc?
317:                 utc_same_instant = self.dup.utc
318:                 utc_same_writing = Time.utc(year,month,day,hour,min,sec,usec)
319:                 difference_to_utc = utc_same_writing - utc_same_instant
320:                 if (difference_to_utc < 0) 
321:                     difference_sign = '-'
322:                     absolute_difference = -difference_to_utc
323:                 else
324:                     difference_sign = '+'
325:                     absolute_difference = difference_to_utc
326:                 end
327:                 difference_minutes = (absolute_difference/60).round
328:                 tz = "%s%02d:%02d" % [ difference_sign, difference_minutes / 60, difference_minutes % 60]
329:             end
330:             standard = self.strftime( "%Y-%m-%d %H:%M:%S" )
331:             standard += ".%06d" % [usec] if usec.nonzero?
332:             standard += " %s" % [tz]
333:             if to_yaml_properties.empty?
334:                 out.scalar( taguri, standard, :plain )
335:             else
336:                 out.map( taguri, to_yaml_style ) do |map|
337:                     map.add( 'at', standard )
338:                     to_yaml_properties.each do |m|
339:                         map.add( m, instance_variable_get( m ) )
340:                     end
341:                 end
342:             end
343:         end
344:         end

Returns the value of time as an integer number of seconds since epoch.

   t = Time.now
   "%10.5f" % t.to_f   #=> "1049896564.17839"
   t.to_i              #=> 1049896564

[Source]

/*
 *  call-seq:
 *     time.to_i   => int
 *     time.tv_sec => int
 *  
 *  Returns the value of <i>time</i> as an integer number of seconds
 *  since epoch.
 *     
 *     t = Time.now
 *     "%10.5f" % t.to_f   #=> "1049896564.17839"
 *     t.to_i              #=> 1049896564
 */

static VALUE
time_to_i(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    return LONG2NUM(tobj->tv.tv_sec);
}

Returns just the number of microseconds for time.

   t = Time.now        #=> Wed Apr 09 08:56:04 CDT 2003
   "%10.6f" % t.to_f   #=> "1049896564.259970"
   t.usec              #=> 259970

[Source]

/*
 *  call-seq:
 *     time.usec    => int
 *     time.tv_usec => int
 *  
 *  Returns just the number of microseconds for <i>time</i>.
 *     
 *     t = Time.now        #=> Wed Apr 09 08:56:04 CDT 2003
 *     "%10.6f" % t.to_f   #=> "1049896564.259970"
 *     t.usec              #=> 259970
 */

static VALUE
time_usec(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    return LONG2NUM(tobj->tv.tv_usec);
}

Returns just the number of microseconds for time.

   t = Time.now        #=> Wed Apr 09 08:56:04 CDT 2003
   "%10.6f" % t.to_f   #=> "1049896564.259970"
   t.usec              #=> 259970

[Source]

/*
 *  call-seq:
 *     time.usec    => int
 *     time.tv_usec => int
 *  
 *  Returns just the number of microseconds for <i>time</i>.
 *     
 *     t = Time.now        #=> Wed Apr 09 08:56:04 CDT 2003
 *     "%10.6f" % t.to_f   #=> "1049896564.259970"
 *     t.usec              #=> 259970
 */

static VALUE
time_usec(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    return LONG2NUM(tobj->tv.tv_usec);
}

Converts time to UTC (GMT), modifying the receiver.

   t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
   t.gmt?         #=> false
   t.gmtime       #=> Wed Apr 09 13:56:03 UTC 2003
   t.gmt?         #=> true

   t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t.utc?         #=> false
   t.utc          #=> Wed Apr 09 13:56:04 UTC 2003
   t.utc?         #=> true

[Source]

/*
 *  call-seq:
 *     time.gmtime    => time
 *     time.utc       => time
 *  
 *  Converts <i>time</i> to UTC (GMT), modifying the receiver.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.gmt?         #=> false
 *     t.gmtime       #=> Wed Apr 09 13:56:03 UTC 2003
 *     t.gmt?         #=> true
 *
 *     t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.utc?         #=> false
 *     t.utc          #=> Wed Apr 09 13:56:04 UTC 2003
 *     t.utc?         #=> true
 */

static VALUE
time_gmtime(time)
    VALUE time;
{
    struct time_object *tobj;
    struct tm *tm_tmp;
    time_t t;

    GetTimeval(time, tobj);
    if (tobj->gmt) {
        if (tobj->tm_got)
            return time;
    }
    else {
        time_modify(time);
    }
    t = tobj->tv.tv_sec;
    tm_tmp = gmtime(&t);
    if (!tm_tmp)
        rb_raise(rb_eArgError, "gmtime error");
    tobj->tm = *tm_tmp;
    tobj->tm_got = 1;
    tobj->gmt = 1;
    return time;
}

Returns true if time represents a time in UTC (GMT).

   t = Time.now                        #=> Wed Apr 09 08:56:04 CDT 2003
   t.utc?                              #=> false
   t = Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
   t.utc?                              #=> true

   t = Time.now                        #=> Wed Apr 09 08:56:03 CDT 2003
   t.gmt?                              #=> false
   t = Time.gm(2000,1,1,20,15,1)       #=> Sat Jan 01 20:15:01 UTC 2000
   t.gmt?                              #=> true

[Source]

/*
 *  call-seq:
 *     time.utc? => true or false
 *     time.gmt? => true or false
 *  
 *  Returns <code>true</code> if <i>time</i> represents a time in UTC
 *  (GMT).
 *     
 *     t = Time.now                        #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.utc?                              #=> false
 *     t = Time.gm(2000,"jan",1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.utc?                              #=> true
 *
 *     t = Time.now                        #=> Wed Apr 09 08:56:03 CDT 2003
 *     t.gmt?                              #=> false
 *     t = Time.gm(2000,1,1,20,15,1)       #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.gmt?                              #=> true
 */

static VALUE
time_utc_p(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->gmt) return Qtrue;
    return Qfalse;
}

Returns the offset in seconds between the timezone of time and UTC.

   t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
   t.gmt_offset                    #=> 0
   l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
   l.gmt_offset                    #=> -21600

[Source]

/*
 *  call-seq:
 *     time.gmt_offset => fixnum
 *     time.gmtoff     => fixnum
 *     time.utc_offset => fixnum
 *  
 *  Returns the offset in seconds between the timezone of <i>time</i>
 *  and UTC.
 *     
 *     t = Time.gm(2000,1,1,20,15,1)   #=> Sat Jan 01 20:15:01 UTC 2000
 *     t.gmt_offset                    #=> 0
 *     l = t.getlocal                  #=> Sat Jan 01 14:15:01 CST 2000
 *     l.gmt_offset                    #=> -21600
 */

static VALUE
time_utc_offset(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }

    if (tobj->gmt == 1) {
        return INT2FIX(0);
    }
    else {
#if defined(HAVE_STRUCT_TM_TM_GMTOFF)
        return INT2NUM(tobj->tm.tm_gmtoff);
#else
        struct tm *u, *l;
        time_t t;
        long off;
        l = &tobj->tm;
        t = tobj->tv.tv_sec;
        u = gmtime(&t);
        if (!u)
            rb_raise(rb_eArgError, "gmtime error");
        if (l->tm_year != u->tm_year)
            off = l->tm_year < u->tm_year ? -1 : 1;
        else if (l->tm_mon != u->tm_mon)
            off = l->tm_mon < u->tm_mon ? -1 : 1;
        else if (l->tm_mday != u->tm_mday)
            off = l->tm_mday < u->tm_mday ? -1 : 1;
        else
            off = 0;
        off = off * 24 + l->tm_hour - u->tm_hour;
        off = off * 60 + l->tm_min - u->tm_min;
        off = off * 60 + l->tm_sec - u->tm_sec;
        return LONG2FIX(off);
#endif
    }
}

[Source]

    # File lib/rss/rss.rb, line 37
37:     def w3cdtf
38:       if usec.zero?
39:         fraction_digits = 0
40:       else
41:         fraction_digits = Math.log10(usec.to_s.sub(/0*$/, '').to_i).floor + 1
42:       end
43:       xmlschema(fraction_digits)
44:     end

Returns an integer representing the day of the week, 0..6, with Sunday == 0.

   t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t.wday         #=> 3

[Source]

/*
 *  call-seq:
 *     time.wday => fixnum
 *  
 *  Returns an integer representing the day of the week, 0..6, with
 *  Sunday == 0.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.wday         #=> 3
 */

static VALUE
time_wday(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_wday);
}

Returns a string which represents the time as dateTime defined by XML Schema:

  CCYY-MM-DDThh:mm:ssTZD
  CCYY-MM-DDThh:mm:ss.sssTZD

where TZD is Z or [+-]hh:mm.

If self is a UTC time, Z is used as TZD. [+-]hh:mm is used otherwise.

fractional_seconds specifies a number of digits of fractional seconds. Its default value is 0.

[Source]

     # File lib/time.rb, line 444
444:   def xmlschema(fraction_digits=0)
445:     sprintf('%d-%02d-%02dT%02d:%02d:%02d',
446:       year, mon, day, hour, min, sec) +
447:     if fraction_digits == 0
448:       ''
449:     elsif fraction_digits <= 6
450:       '.' + sprintf('%06d', usec)[0, fraction_digits]
451:     else
452:       '.' + sprintf('%06d', usec) + '0' * (fraction_digits - 6)
453:     end +
454:     if utc?
455:       'Z'
456:     else
457:       off = utc_offset
458:       sign = off < 0 ? '-' : '+'
459:       sprintf('%s%02d:%02d', sign, *(off.abs / 60).divmod(60))
460:     end
461:   end

Returns an integer representing the day of the year, 1..366.

   t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t.yday         #=> 99

[Source]

/*
 *  call-seq:
 *     time.yday => fixnum
 *  
 *  Returns an integer representing the day of the year, 1..366.
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.yday         #=> 99
 */

static VALUE
time_yday(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return INT2FIX(tobj->tm.tm_yday+1);
}

Returns the year for time (including the century).

   t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
   t.year         #=> 2003

[Source]

/*
 *  call-seq:
 *     time.year => fixnum
 *  
 *  Returns the year for <i>time</i> (including the century).
 *     
 *     t = Time.now   #=> Wed Apr 09 08:56:04 CDT 2003
 *     t.year         #=> 2003
 */

static VALUE
time_year(time)
    VALUE time;
{
    struct time_object *tobj;

    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }
    return LONG2NUM((long)tobj->tm.tm_year+1900);
}

Returns the name of the time zone used for time. As of Ruby 1.8, returns ``UTC’’ rather than ``GMT’’ for UTC times.

   t = Time.gm(2000, "jan", 1, 20, 15, 1)
   t.zone   #=> "UTC"
   t = Time.local(2000, "jan", 1, 20, 15, 1)
   t.zone   #=> "CST"

[Source]

/*
 *  call-seq:
 *     time.zone => string
 *  
 *  Returns the name of the time zone used for <i>time</i>. As of Ruby
 *  1.8, returns ``UTC'' rather than ``GMT'' for UTC times.
 *     
 *     t = Time.gm(2000, "jan", 1, 20, 15, 1)
 *     t.zone   #=> "UTC"
 *     t = Time.local(2000, "jan", 1, 20, 15, 1)
 *     t.zone   #=> "CST"
 */

static VALUE
time_zone(time)
    VALUE time;
{
    struct time_object *tobj;
#if !defined(HAVE_TM_ZONE) && (!defined(HAVE_TZNAME) || !defined(HAVE_DAYLIGHT))
    char buf[64];
    int len;
#endif
    
    GetTimeval(time, tobj);
    if (tobj->tm_got == 0) {
        time_get_tm(time, tobj->gmt);
    }

    if (tobj->gmt == 1) {
        return rb_str_new2("UTC");
    }
#if defined(HAVE_TM_ZONE)
    return rb_str_new2(tobj->tm.tm_zone);
#elif defined(HAVE_TZNAME) && defined(HAVE_DAYLIGHT)
    return rb_str_new2(tzname[daylight && tobj->tm.tm_isdst]);
#else
    len = strftime(buf, 64, "%Z", &tobj->tm);
    return rb_str_new(buf, len);
#endif
}

[Validate]