Time < Object

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 17
    def ===(other)
      super || (self == Time && other.is_a?(ActiveSupport::TimeWithZone))
    end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 44
    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 38
    def current
      ::Time.zone ? ::Time.zone.now : ::Time.now
    end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 23
    def days_in_month(month, year = current.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/calculations.rb, line 33
    def days_in_year(year = current.year)
      days_in_month(2, year) + 337
    end

# File activesupport/lib/active_support/core_ext/time/zones.rb, line 109
    def find_zone(time_zone)
      find_zone!(time_zone) rescue nil
    end

# File activesupport/lib/active_support/core_ext/time/zones.rb, line 82
    def find_zone!(time_zone)
      if !time_zone || time_zone.is_a?(ActiveSupport::TimeZone)
        time_zone
      else
        # Look up the timezone based on the 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/calculations.rb, line 66
    def rfc3339(str)
      parts = Date._rfc3339(str)

      raise ArgumentError, "invalid date" if parts.empty?

      Time.new(
        parts.fetch(:year),
        parts.fetch(:mon),
        parts.fetch(:mday),
        parts.fetch(:hour),
        parts.fetch(:min),
        parts.fetch(:sec) + parts.fetch(:sec_fraction, 0),
        parts.fetch(:offset)
      )
    end

# File activesupport/lib/active_support/core_ext/time/zones.rb, line 62
    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/zones.rb, line 14
    def zone
      Thread.current[:time_zone] || zone_default
    end

# File activesupport/lib/active_support/core_ext/time/zones.rb, line 41
    def zone=(time_zone)
      Thread.current[:time_zone] = find_zone!(time_zone)
    end

# File activesupport/lib/active_support/core_ext/time/acts_like.rb, line 7
  def acts_like_time?
    true
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 162
  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 189
  def ago(seconds)
    since(-seconds)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 202
  def beginning_of_day
    change(hour: 0)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 231
  def beginning_of_hour
    change(min: 0)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 247
  def beginning_of_minute
    change(sec: 0)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 120
  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)
    new_offset = options.fetch(:offset, nil)

    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

    raise ArgumentError, "argument out of range" if new_usec >= 1000000

    new_sec += Rational(new_usec, 1000000)

    if new_offset
      ::Time.new(new_year, new_month, new_day, new_hour, new_min, new_sec, new_offset)
    elsif utc?
      ::Time.utc(new_year, new_month, new_day, new_hour, new_min, new_sec)
    elsif zone
      ::Time.local(new_year, new_month, new_day, new_hour, new_min, new_sec)
    else
      ::Time.new(new_year, new_month, new_day, new_hour, new_min, new_sec, utc_offset)
    end
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 293
  def compare_with_coercion(other)
    # we're avoiding Time#to_datetime and Time#to_time because they're 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 220
  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 237
  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 253
  def end_of_minute
    change(
      sec: 59,
      usec: Rational(999999999, 1000)
    )
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 308
  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/conversions.rb, line 66
  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 210
  def middle_of_day
    change(hour: 12)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 284
  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 104
  def sec_fraction
    subsec
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 88
  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 97
  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 194
  def since(seconds)
    self + seconds
  rescue
    to_datetime.since(seconds)
  end

# File activesupport/lib/active_support/core_ext/time/conversions.rb, line 51
  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/compatibility.rb, line 13
  def to_time
    preserve_timezone ? self : getlocal
  end