| class methods | 
| at | Time.at( aTime ) -> aTime Time.at( seconds [, microseconds] ) 
          -> aTime
 | 
 | Creates a new time object with the value given by aTime,
      or the given number of seconds (and optional microseconds)
      from epoch. 
  | Time.at(0) | » | Wed Dec 31 18:00:00 CST 1969 |  
  | Time.at(946702800) | » | Fri Dec 31 23:00:00 CST 1999 |  | | gm | Time.gm( year [, month, day, hour, min, sec, usec] )
        -> aTime Time.gm( sec, min, hour, day, month, year, wday, yday,
            isdst, tz )
        -> aTime
 | 
 | 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 nilor 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 anArgumentErrorif any values are out of range.  Will also
    accept ten arguments in the order output byTime#to_a.
  | Time.gm(2000,"jan",1,20,15,1) | » | Sat Jan 01 20:15:01 UTC 2000 |  | | local | Time.local( year [, month, day, hour, min, sec, usec] )
          -> aTime Time.local( sec, min, hour, day, month, year, wday, yday, isdst, tz )
          -> aTime
 | 
 | 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 |  | | mktime | Time.mktime(
        year, month, day, hour, min, sec, usec )
        -> aTime | 
 | Synonym for Time::local. | | new | Time.new
        -> aTime | 
 | Returns a Timeobject 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 | » | Sun Mar 04 23:30:26 CST 2001 |  
  | b = Time.new | » | Sun Mar 04 23:30:26 CST 2001 |  
  | a == b | » | false |  
  | "%.6f" % a.to_f | » | "983770226.132865" |  
  | "%.6f" % b.to_f | » | "983770226.133372" |  | | now | Time.now -> aTime | 
 | Synonym for Time::new. | | times | Time.times
        -> aStructTms | 
 | Returns a Tmsstructure (seeStruct::Tmson page 388) that contains
      user and system CPU times for this process.
| t = Time.times |  
  | [ t.utime, t.stime ] | » | [0.0, 0.01] |  | | utc | Time.utc( year [, month, day, hour, min, sec, usec] )
        -> aTime Time.utc( sec, min, hour, day, month, year, wday, yday,
            isdst, tz )
        -> aTime
 | 
 | Synonym for Time::gm.
  | Time.utc(2000,"jan",1,20,15,1) | » | Sat Jan 01 20:15:01 UTC 2000 |  | 
| instance methods | 
| + | time + aNumeric 
        -> aTime | 
 | Addition---Adds some number of seconds (possibly fractional) to time
      and returns that value as a new time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t + (60 * 60 * 24) | » | Mon Mar 05 23:30:26 CST 2001 |  | | -- | time -aTime -> aFloattime
 -aNumeric -> aTime | 
 | Difference---Returns a new time that represents the difference between two
      times, or subtracts the given number of seconds in
      aNumeric from time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t2 = t + 2592000 | » | Wed Apr 04 00:30:26 CDT 2001 |  
  | t2 - t | » | 2592000.0 |  
  | t2 - 2592000 | » | Sun Mar 04 23:30:26 CST 2001 |  | | <=> | time <=> anOtherTime
        -> -1, 0, +1 time <=> aNumeric
        -> -1, 0, +1
 | 
 | Comparison---Compares time with anOtherTime or with
      aNumeric, which is the number of seconds (possibly
      fractional) since epoch. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t2 = t + 2592000 | » | Wed Apr 04 00:30:26 CDT 2001 |  
  | t <=> t2 | » | -1 |  
  | t2 <=> t | » | 1 |  
  | t <=> t | » | 0 |  | | asctime | time.asctime
        -> aString | 
 | Returns a canonical string representation of time. 
  | Time.now.asctime | » | "Sun Mar  4 23:30:26 2001" |  | | ctime | time.ctime
        -> aString | 
 | Synonym for Time#asctime. | | day | time.day
        -> aFixnum | 
 | Returns the day of the month (1..n) for time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.day | » | 4 |  | | gmt? | time.gmt?
        -> trueorfalse | 
 | Returns trueif time represents a time in UTC (GMT).
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.gmt? | » | false |  
  | t = Time.gm(2000,"jan",1,20,15,1) | » | Sat Jan 01 20:15:01 UTC 2000 |  
  | t.gmt? | » | true |  | | gmtime | time.gmtime
        -> time | 
 | Converts time to UTC (GMT), modifying the receiver. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.gmt? | » | false |  
  | t.gmtime | » | Mon Mar 05 05:30:26 UTC 2001 |  
  | t.gmt? | » | true |  | | hour | time.hour
        -> aFixnum | 
 | Returns the hour of the day (0..23) for time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.hour | » | 23 |  | | isdst | time.isdst
        -> trueorfalse | 
 | Returns trueif time occurs during Daylight Saving 
      Time in its time zone.
  | t  = Time.local(2000, 7, 1) | » | Sat Jul 01 00:00:00 CDT 2000 |  
  | t.isdst | » | true |  
  | t2 = Time.local(2000, 1, 1) | » | Sat Jan 01 00:00:00 CST 2000 |  
  | t2.isdst | » | false |  | | localtime | time.localtime
        -> time | 
 | 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 |  | | mday | time.mday
        -> aFixnum | 
 | Synonym for Time#day. | | min | time.min
        -> aFixnum | 
 | Returns the minute of the hour (0..59) for time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.min | » | 30 |  | | mon | time.mon
        -> aFixnum | 
 | Returns the month of the year (1..12) for time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.mon | » | 3 |  | | month | time.month
        -> aFixnum | 
 | Synonym for Time#mon. | | sec | time.sec
        -> aFixnum | 
 | 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 | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.sec | » | 26 |  | | strftime | time.strftime( aString )
        -> aString | 
 | Formats time according to the directives in the given format
      string.  See Table 22.9 on page 402 for the available values.
      Any text not listed as a directive will be passed through to the
      output string. 
| t = Time.now |  
  | t.strftime("Printed on %m/%d/%Y") | » | "Printed on 03/04/2001" |  
  | t.strftime("at %I:%M%p") | » | "at 11:30PM" |  | Time#strftimedirectives
  | 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 |  |  |  | 
 | | to_a | time.to_a
        -> anArray | 
 | Returns a ten-element anArray
      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 toTime::utcorTime::localto create a newTime.
  | now = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t = now.to_a | » | [26, 30, 23, 4, 3, 2001, 0, 63, false, "CST"] |  | | to_f | time.to_f
        -> aFloat | 
 | Returns the value of time as a floating point number of
      seconds since epoch. 
| t = Time.now |  
  | "%10.5f" % t.to_f | » | "983770226.64529" |  
  | t.to_i | » | 983770226 |  | | to_i | time.to_i
        -> anInteger | 
 | Returns the value of time as an integer number of
      seconds since epoch. 
| t = Time.now |  
  | "%10.5f" % t.to_f | » | "983770226.67497" |  
  | t.to_i | » | 983770226 |  | | to_s | time.to_s
        -> aString | 
 | Returns a string representing time.  Equivalent to calling Time#strftimewith a format string of 
        ``%a%b%d%H:%M:%S%Z%Y''.
  | Time.now.to_s | » | "Sun Mar 04 23:30:26 CST 2001" |  | | tv_sec | time.tv_sec
        -> anInteger | 
 | Synonym for Time#to_i. | | tv_usec | time.tv_usec
        -> anInteger | 
 | Synonym for Time#usec. | | usec | time.usec
        -> anInteger | 
 | Returns just the number of microseconds for time. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | "%10.6f" % t.to_f | » | "983770226.729373" |  
  | t.usec | » | 729373 |  | | utc | time.utc -> time | 
 | Synonym for Time#gmtime.
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.utc? | » | false |  
  | t.utc | » | Mon Mar 05 05:30:26 UTC 2001 |  
  | t.utc? | » | true |  | | utc? | time.utc? -> trueorfalse | 
 | Returns trueif time represents a time in UTC (GMT).
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.utc? | » | false |  
  | t = Time.gm(2000,"jan",1,20,15,1) | » | Sat Jan 01 20:15:01 UTC 2000 |  
  | t.utc? | » | true |  | | wday | time.wday
        -> aFixnum | 
 | Returns an integer representing the day of the week, 0..6,
      with Sunday == 0. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.wday | » | 0 |  | | yday | time.yday
        -> aFixnum | 
 | Returns an integer representing the day of the year, 1..366. 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.yday | » | 63 |  | | year | time.year
        -> aFixnum | 
 | Returns the year for time (including the century). 
  | t = Time.now | » | Sun Mar 04 23:30:26 CST 2001 |  
  | t.year | » | 2001 |  | | zone | time.zone
        -> aString | 
 | Returns the name of the time zone used for time. 
| t = Time.gm(2000, "jan", 1, 20, 15, 1) |  
  | t.zone | » | "GMT" |  
| t = Time.local(2000, "jan", 1, 20, 15, 1) |  
  | t.zone | » | "CST" |  |