Class: Time

# File 'activesupport/lib/active_support/core_ext/time/zones.rb', line 39

def zone=(time_zone)
  Thread.current[:time_zone] = find_zone!(time_zone)
end

# File 'activesupport/lib/active_support/core_ext/time/zones.rb', line 8

attr_accessor :zone_default

# File 'activesupport/lib/active_support/core_ext/time/marshal.rb', line 8

def _load(marshaled_time)
  time = _load_without_zone(marshaled_time)
  time.instance_eval do
    if zone = defined?(@_zone) && remove_instance_variable('@_zone')
      ary = to_a
      ary[0] += subsec if ary[0] == sec
      ary[-1] = zone
      utc? ? Time.utc(*ary) : Time.local(*ary)
    else
      self
    end
  end
end

# File 'activesupport/lib/active_support/core_ext/time/marshal.rb', line 7

alias_method :_load_without_zone, :_load

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 49

alias_method :at, :at_with_coercion

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 36

def at_with_coercion(*args)
  return at_without_coercion(*args) if args.size != 1

  # Time.at can be called with a time or numerical value
  time_or_number = args.first

  if time_or_number.is_a?(ActiveSupport::TimeWithZone) || time_or_number.is_a?(DateTime)
    at_without_coercion(time_or_number.to_f).getlocal
  else
    at_without_coercion(time_or_number)
  end
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 48

alias_method :at_without_coercion, :at

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 30

def current
  ::Time.zone ? ::Time.zone.now : ::Time.now
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 21

def days_in_month(month, year = now.year)
  if month == 2 && ::Date.gregorian_leap?(year)
    29
  else
    COMMON_YEAR_DAYS_IN_MONTH[month]
  end
end

# File 'activesupport/lib/active_support/core_ext/time/zones.rb', line 75

def find_zone(time_zone)
  find_zone!(time_zone) rescue nil
end

# File 'activesupport/lib/active_support/core_ext/time/zones.rb', line 55

def find_zone!(time_zone)
  if !time_zone || time_zone.is_a?(ActiveSupport::TimeZone)
    time_zone
  else
    # lookup timezone based on identifier (unless we've been passed a TZInfo::Timezone)
    unless time_zone.respond_to?(:period_for_local)
      time_zone = ActiveSupport::TimeZone[time_zone] || TZInfo::Timezone.get(time_zone)
    end

    # Return if a TimeZone instance, or wrap in a TimeZone instance if a TZInfo::Timezone
    if time_zone.is_a?(ActiveSupport::TimeZone)
      time_zone
    else
      ActiveSupport::TimeZone.create(time_zone.name, nil, time_zone)
    end
  end
rescue TZInfo::InvalidTimezoneIdentifier
  raise ArgumentError, "Invalid Timezone: #{time_zone}"
end

# File 'activesupport/lib/active_support/core_ext/time/zones.rb', line 44

def use_zone(time_zone)
  new_zone = find_zone!(time_zone)
  begin
    old_zone, ::Time.zone = ::Time.zone, new_zone
    yield
  ensure
    ::Time.zone = old_zone
  end
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 244

alias_method :-, :minus_with_duration

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 269

alias_method :<=>, :compare_with_coercion

# File 'activesupport/lib/active_support/core_ext/time/marshal.rb', line 24

def _dump(*args)
  obj = dup
  obj.instance_variable_set('@_zone', zone)
  obj.send :_dump_without_zone, *args
end

# File 'activesupport/lib/active_support/core_ext/time/marshal.rb', line 23

alias_method :_dump_without_zone, :_dump

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 121

def advance(options)
  unless options[:weeks].nil?
    options[:weeks], partial_weeks = options[:weeks].divmod(1)
    options[:days] = options.fetch(:days, 0) + 7 * partial_weeks
  end

  unless options[:days].nil?
    options[:days], partial_days = options[:days].divmod(1)
    options[:hours] = options.fetch(:hours, 0) + 24 * partial_days
  end

  d = to_date.advance(options)
  d = d.gregorian if d.julian?
  time_advanced_by_date = change(:year => d.year, :month => d.month, :day => d.day)
  seconds_to_advance = \
    options.fetch(:seconds, 0) +
    options.fetch(:minutes, 0) * 60 +
    options.fetch(:hours, 0) * 3600

  if seconds_to_advance.zero?
    time_advanced_by_date
  else
    time_advanced_by_date.since(seconds_to_advance)
  end
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 148

def ago(seconds)
  since(-seconds)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 222

def all_day
  beginning_of_day..end_of_day
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 167

alias :at_beginning_of_day :beginning_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 194

alias :at_beginning_of_hour :beginning_of_hour

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 210

alias :at_beginning_of_minute :beginning_of_minute

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 188

alias :at_end_of_day :end_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 204

alias :at_end_of_hour :end_of_hour

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 219

alias :at_end_of_minute :end_of_minute

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 175

alias :at_midday :middle_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 177

alias :at_middle_of_day :middle_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 166

alias :at_midnight :beginning_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 176

alias :at_noon :middle_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 161

def beginning_of_day
  #(self - seconds_since_midnight).change(usec: 0)
  change(:hour => 0)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 191

def beginning_of_hour
  change(:min => 0)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 207

def beginning_of_minute
  change(:sec => 0)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 85

def change(options)
  new_year  = options.fetch(:year, year)
  new_month = options.fetch(:month, month)
  new_day   = options.fetch(:day, day)
  new_hour  = options.fetch(:hour, hour)
  new_min   = options.fetch(:min, options[:hour] ? 0 : min)
  new_sec   = options.fetch(:sec, (options[:hour] || options[:min]) ? 0 : sec)

  if new_nsec = options[:nsec]
    raise ArgumentError, "Can't change both :nsec and :usec at the same time: #{options.inspect}" if options[:usec]
    new_usec = Rational(new_nsec, 1000)
  else
    new_usec  = options.fetch(:usec, (options[:hour] || options[:min] || options[:sec]) ? 0 : Rational(nsec, 1000))
  end

  if utc?
    ::Time.utc(new_year, new_month, new_day, new_hour, new_min, new_sec, new_usec)
  elsif zone
    ::Time.local(new_year, new_month, new_day, new_hour, new_min, new_sec, new_usec)
  else
    raise ArgumentError, 'argument out of range' if new_usec >= 1000000
    ::Time.new(new_year, new_month, new_day, new_hour, new_min, new_sec + (new_usec.to_r / 1000000), utc_offset)
  end
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 258

def compare_with_coercion(other)
  # we're avoiding Time#to_datetime cause it's expensive
  if other.class == Time
    compare_without_coercion(other)
  elsif other.is_a?(Time)
    compare_without_coercion(other.to_time)
  else
    to_datetime <=> other
  end
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 268

alias_method :compare_without_coercion, :<=>

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 180

def end_of_day
  change(
    :hour => 23,
    :min => 59,
    :sec => 59,
    :usec => Rational(999999999, 1000)
  )
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 197

def end_of_hour
  change(
    :min => 59,
    :sec => 59,
    :usec => Rational(999999999, 1000)
  )
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 213

def end_of_minute
  change(
    :sec => 59,
    :usec => Rational(999999999, 1000)
  )
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 279

alias_method :eql?, :eql_with_coercion

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 273

def eql_with_coercion(other)
  # if other is an ActiveSupport::TimeWithZone, coerce a Time instance from it so we can do eql? comparison
  other = other.comparable_time if other.respond_to?(:comparable_time)
  eql_without_coercion(other)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 278

alias_method :eql_without_coercion, :eql?

# File 'activesupport/lib/active_support/core_ext/time/conversions.rb', line 62

def formatted_offset(colon = true, alternate_utc_string = nil)
  utc? && alternate_utc_string || ActiveSupport::TimeZone.seconds_to_utc_offset(utc_offset, colon)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 158

alias :in :since

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 173

alias :midday :middle_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 170

def middle_of_day
  change(:hour => 12)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 165

alias :midnight :beginning_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 249

def minus_with_coercion(other)
  other = other.comparable_time if other.respond_to?(:comparable_time)
  other.is_a?(DateTime) ? to_f - other.to_f : minus_without_coercion(other)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 253

alias_method :minus_without_coercion, :-

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 243

alias_method :minus_without_duration, :-

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 174

alias :noon :middle_of_day

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 233

alias_method :plus_without_duration, :+

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 69

def sec_fraction
  subsec
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 53

def seconds_since_midnight
  to_i - change(:hour => 0).to_i + (usec / 1.0e+6)
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 62

def seconds_until_end_of_day
  end_of_day.to_i - to_i
end

# File 'activesupport/lib/active_support/core_ext/time/calculations.rb', line 153

def since(seconds)
  self + seconds
rescue
  to_datetime.since(seconds)
end

# File 'activesupport/lib/active_support/core_ext/time/conversions.rb', line 55

alias_method :to_default_s, :to_s

# File 'activesupport/lib/active_support/core_ext/time/conversions.rb', line 48

def to_formatted_s(format = :default)
  if formatter = DATE_FORMATS[format]
    formatter.respond_to?(:call) ? formatter.call(self).to_s : strftime(formatter)
  else
    to_default_s
  end
end

# File 'activesupport/lib/active_support/core_ext/time/conversions.rb', line 56

alias_method :to_s, :to_formatted_s

# File 'activesupport/lib/active_support/core_ext/time/compatibility.rb', line 11

def to_time
  preserve_timezone ? self : getlocal
end