Module: DateAndTime::Compatibility

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In: `::ActiveRecord::Type::Time::Value`, `::ActiveSupport::TimeWithZone`, `::DateTime`, `::Time`
Defined in:	activesupport/lib/active_support/core_ext/date_and_time/compatibility.rb

Class Attribute Summary

.preserve_timezone= rw
.utc_to_local_returns_utc_offset_times (also: #utc_to_local_returns_utc_offset_times) rw

Change the output of ActiveSupport::TimeZone.utc_to_local.
.preserve_timezone rw Internal use only

If true, to_time preserves the timezone offset of receiver.

Instance Attribute Summary

#utc_to_local_returns_utc_offset_times readonly

Instance Method Summary

#preserve_timezone Internal use only

Class Attribute Details

.preserve_timezone (rw)

This method is for internal use only.

If true, to_time preserves the timezone offset of receiver.

NOTE: With Ruby 2.4+ the default for to_time changed from converting to the local system time, to preserving the offset of the receiver. For backwards compatibility we’re overriding this behavior, but new apps will have an initializer that sets this to true, because the new behavior is preferred.

[ GitHub ]

# File 'activesupport/lib/active_support/core_ext/date_and_time/compatibility.rb', line 24


mattr_accessor :preserve_timezone, instance_accessor: false, default: nil

.preserve_timezone= (rw)

[ GitHub ]

# File 'activesupport/lib/active_support/core_ext/date_and_time/compatibility.rb', line 15


mattr_accessor :preserve_timezone, instance_accessor: false, default: nil

.utc_to_local_returns_utc_offset_times (rw) Also known as: #utc_to_local_returns_utc_offset_times

Change the output of ActiveSupport::TimeZone.utc_to_local.

When true, it returns local times with a UTC offset, with false local times are returned as UTC.

# Given this zone:
zone = ActiveSupport::TimeZone["Eastern Time (US & Canada)"]

# With `utc_to_local_returns_utc_offset_times = false`, local time is converted to UTC:
zone.utc_to_local(Time.utc(2000, 1)) # => 1999-12-31 19:00:00 UTC

# With `utc_to_local_returns_utc_offset_times = true`, local time is returned with UTC offset:
zone.utc_to_local(Time.utc(2000, 1)) # => 1999-12-31 19:00:00 -0500

[ GitHub ]

# File 'activesupport/lib/active_support/core_ext/date_and_time/compatibility.rb', line 56


mattr_accessor :utc_to_local_returns_utc_offset_times, instance_writer: false, default: false

Instance Attribute Details

#utc_to_local_returns_utc_offset_times (readonly)

[ GitHub ]

# File 'activesupport/lib/active_support/core_ext/date_and_time/compatibility.rb', line 56


mattr_accessor :utc_to_local_returns_utc_offset_times, instance_writer: false, default: false

Instance Method Details

#preserve_timezone

This method is for internal use only.

[ GitHub ]

# File 'activesupport/lib/active_support/core_ext/date_and_time/compatibility.rb', line 39


def preserve_timezone # :nodoc:
  Compatibility.preserve_timezone
end