Methods
Attributes
[RW] zone_default
Public Instance methods
current()

Returns Time.zone.now when config.time_zone is set, otherwise just returns Time.now.

[ show source ]

    # File activesupport/lib/active_support/core_ext/time/zones.rb, line 50
50:           def current
51:             ::Time.zone_default ? ::Time.zone.now : ::Time.now
52:           end
use_zone(time_zone) {|| ...}

Allows override of Time.zone locally inside supplied block; resets Time.zone to existing value when done.

[ show source ]

    # File activesupport/lib/active_support/core_ext/time/zones.rb, line 42
42:           def use_zone(time_zone)
43:             old_zone, ::Time.zone = ::Time.zone, get_zone(time_zone)
44:             yield
45:           ensure
46:             ::Time.zone = old_zone
47:           end
zone()

Returns the TimeZone for the current request, if this has been set (via Time.zone=). If Time.zone has not been set for the current request, returns the TimeZone specified in config.time_zone.

[ show source ]

    # File activesupport/lib/active_support/core_ext/time/zones.rb, line 14
14:           def zone
15:             Thread.current[:time_zone] || zone_default
16:           end
zone=(time_zone)

Sets Time.zone to a TimeZone object for the current request/thread.

This method accepts any of the following:

  • A Rails TimeZone object.
  • An identifier for a Rails TimeZone object (e.g., "Eastern Time (US & Canada)", -5.hours).
  • A TZInfo::Timezone object.
  • An identifier for a TZInfo::Timezone object (e.g., "America/New_York").

Here‘s an example of how you might set Time.zone on a per request basis — current_user.time_zone just needs to return a string identifying the user‘s preferred TimeZone: 

  class ApplicationController < ActionController::Base
    before_filter :set_time_zone

    def set_time_zone
      Time.zone = current_user.time_zone
    end
  end

[ show source ]

    # File activesupport/lib/active_support/core_ext/time/zones.rb, line 37
37:           def zone=(time_zone)
38:             Thread.current[:time_zone] = get_zone(time_zone)
39:           end