Module: ActiveSupport::CoreExtensions::Time::Zones

Included in:
DateTime, Time
Defined in:
lib/active_support/core_ext/time/zones.rb

Defined Under Namespace

Modules: ClassMethods

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object

:nodoc:


5
6
7
# File 'lib/active_support/core_ext/time/zones.rb', line 5

def self.included(base) #:nodoc:
  base.extend(ClassMethods) if base == ::Time # i.e., don't include class methods in DateTime
end

Instance Method Details

#in_time_zone(zone = ::Time.zone) ⇒ Object

Returns the simultaneous time in Time.zone.

Time.zone = 'Hawaii'         # => 'Hawaii'
Time.utc(2000).in_time_zone  # => Fri, 31 Dec 1999 14:00:00 HST -10:00

This method is similar to Time#localtime, except that it uses Time.zone as the local zone instead of the operating system's time zone.

You can also pass in a TimeZone instance or string that identifies a TimeZone as an argument, and the conversion will be based on that zone instead of Time.zone.

Time.utc(2000).in_time_zone('Alaska')  # => Fri, 31 Dec 1999 15:00:00 AKST -09:00

80
81
82
# File 'lib/active_support/core_ext/time/zones.rb', line 80

def in_time_zone(zone = ::Time.zone)
  ActiveSupport::TimeWithZone.new(utc? ? self : getutc, ::Time.send!(:get_zone, zone))
end