Time < Object

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 45
    def at_with_coercion(*args, **kwargs)
      return at_without_coercion(*args, **kwargs) if args.size != 1 || !kwargs.empty?

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

      if time_or_number.is_a?(ActiveSupport::TimeWithZone)
        at_without_coercion(time_or_number.to_r).getlocal
      elsif 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 39
    def current
      ::Time.zone ? ::Time.zone.now : ::Time.now
    end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 24
    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 34
    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 93
    def find_zone(time_zone)
      find_zone!(time_zone) rescue nil
    end

# File activesupport/lib/active_support/core_ext/time/zones.rb, line 81
    def find_zone!(time_zone)
      return time_zone unless time_zone

      ActiveSupport::TimeZone[time_zone] || raise(ArgumentError, "Invalid Timezone: #{time_zone}")
    end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 69
    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 61
    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
      ::ActiveSupport::IsolatedExecutionState[:time_zone] || zone_default
    end

# File activesupport/lib/active_support/core_ext/time/zones.rb, line 41
    def zone=(time_zone)
      ::ActiveSupport::IsolatedExecutionState[: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 202
  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.gregorian.advance(options)
    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 228
  def ago(seconds)
    since(-seconds)
  end

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

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

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 121
    def ceil(precision = 0)
      change(nsec: 0) + subsec.ceil(precision)
    end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 138
  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&.respond_to?(:utc_to_local)
      new_time = ::Time.new(new_year, new_month, new_day, new_hour, new_min, new_sec, zone)

      # When there are two occurrences of a nominal time due to DST ending,
      # `Time.new` chooses the first chronological occurrence (the one with a
      # larger UTC offset). However, for `change`, we want to choose the
      # occurrence that matches this time's UTC offset.
      #
      # If the new time's UTC offset is larger than this time's UTC offset, the
      # new time might be a first chronological occurrence. So we add the offset
      # difference to fast-forward the new time, and check if the result has the
      # desired UTC offset (i.e. is the second chronological occurrence).
      offset_difference = new_time.utc_offset - utc_offset
      if offset_difference > 0 && (new_time_2 = new_time + offset_difference).utc_offset == utc_offset
        new_time_2
      else
        new_time
      end
    elsif zone
      ::Time.local(new_sec, new_min, new_hour, new_day, new_month, new_year, nil, nil, isdst, nil)
    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 332
  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 259
  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 276
  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 292
  def end_of_minute
    change(
      sec: 59,
      usec: Rational(999999999, 1000)
    )
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 347
  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 112
    def floor(precision = 0)
      change(nsec: 0) + subsec.floor(precision)
    end

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 323
  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 361
  def next_day(days = 1)
    advance(days: days)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 371
  def next_month(months = 1)
    advance(months: months)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 381
  def next_year(years = 1)
    advance(years: years)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 356
  def prev_day(days = 1)
    advance(days: -days)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 366
  def prev_month(months = 1)
    advance(months: -months)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 376
  def prev_year(years = 1)
    advance(years: -years)
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 107
  def sec_fraction
    subsec
  end

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

# File activesupport/lib/active_support/core_ext/time/conversions.rb, line 53
  def to_fs(format = :default)
    if formatter = DATE_FORMATS[format]
      formatter.respond_to?(:call) ? formatter.call(self).to_s : strftime(formatter)
    else
      to_s
    end
  end

# File activesupport/lib/active_support/core_ext/time/compatibility.rb, line 13
  def to_time
    preserve_timezone ? self : getlocal
  end