ri > ActiveSupport::TimeWithZone

= ActiveSupport::TimeWithZone < Object

(from /home/chedong/.local/share/rdoc)
------------------------------------------------------------------------
A Time-like class that can represent a time in any time zone. Necessary
because standard Ruby Time instances are limited to UTC and the system's
ENV['TZ'] zone.

You shouldn't ever need to create a TimeWithZone instance directly via
new. Instead use methods local, parse, at and now on TimeZone instances,
and in_time_zone on Time and DateTime instances.

  Time.zone = 'Eastern Time (US & Canada)'        # => 'Eastern Time (US & Canada)'
  Time.zone.local(2007, 2, 10, 15, 30, 45)        # => Sat, 10 Feb 2007 15:30:45.000000000 EST -05:00
  Time.zone.parse('2007-02-10 15:30:45')          # => Sat, 10 Feb 2007 15:30:45.000000000 EST -05:00
  Time.zone.at(1171139445)                        # => Sat, 10 Feb 2007 15:30:45.000000000 EST -05:00
  Time.zone.now                                   # => Sun, 18 May 2008 13:07:55.754107581 EDT -04:00
  Time.utc(2007, 2, 10, 20, 30, 45).in_time_zone  # => Sat, 10 Feb 2007 15:30:45.000000000 EST -05:00

See Time and TimeZone for further documentation of these methods.

TimeWithZone instances implement the same API as Ruby Time instances, so
that Time and TimeWithZone instances are interchangeable.

  t = Time.zone.now                     # => Sun, 18 May 2008 13:27:25.031505668 EDT -04:00
  t.hour                                # => 13
  t.dst?                                # => true
  t.utc_offset                          # => -14400
  t.zone                                # => "EDT"
  t.to_s(:rfc822)                       # => "Sun, 18 May 2008 13:27:25 -0400"
  t + 1.day                             # => Mon, 19 May 2008 13:27:25.031505668 EDT -04:00
  t.beginning_of_year                   # => Tue, 01 Jan 2008 00:00:00.000000000 EST -05:00
  t > Time.utc(1999)                    # => true
  t.is_a?(Time)                         # => true
  t.is_a?(ActiveSupport::TimeWithZone)  # => true
------------------------------------------------------------------------
= Constants:

PRECISIONS:
  [not documented]

SECONDS_PER_DAY:
  [not documented]


= Class methods:

  name
  new

= Instance methods:

  +
  -
  <=>
  acts_like_time?
  advance
  ago
  as_json
  between?
  blank?
  change
  comparable_time
  dst?
  eql?
  formatted_offset
  freeze
  future?
  getgm
  getlocal
  getutc
  gmt?
  gmt_offset
  gmtime
  gmtoff
  hash
  httpdate
  in
  in_time_zone
  inspect
  is_a?
  isdst
  iso8601
  kind_of?
  localtime
  marshal_dump
  marshal_load
  method_missing
  next_day?
  past?
  period
  prev_day?
  respond_to?
  respond_to_missing?
  rfc2822
  rfc3339
  rfc822
  since
  strftime
  time
  time_zone
  to_a
  to_datetime
  to_f
  to_formatted_s
  to_i
  to_r
  to_s
  to_time
  today?
  tomorrow?
  tv_sec
  utc
  utc?
  utc_offset
  xmlschema
  yesterday?
  zone

= Attributes:

  attr_reader time_zone