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(time_or_number, *args)
      if args.empty?
        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
      else
        at_without_coercion(time_or_number, *args)
      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 194
  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 220
  def ago(seconds)
    since(-seconds)
  end

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

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

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 123
  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)

      # Some versions of Ruby have a bug where Time.new with a zone object and
      # fractional seconds will end up with a broken utc_offset.
      # This is fixed in Ruby 3.3.1 and 3.2.4
      unless new_time.utc_offset.integer?
        new_time += 0
      end

      # 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 329
  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)
      # also avoid ActiveSupport::TimeWithZone#to_time before Rails 8.0
      if other.respond_to?(:comparable_time)
        compare_without_coercion(other.comparable_time)
      else
        compare_without_coercion(other.to_time)
      end
    else
      to_datetime <=> other
    end
  end

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 256
  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 273
  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 289
  def end_of_minute
    change(
      sec: 59,
      usec: Rational(999999999, 1000)
    )
  end

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

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

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

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

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

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 378
  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 225
  def since(seconds)
    self + seconds
  rescue TypeError
    result = to_datetime.since(seconds)
    ActiveSupport.deprecator.warn(
      "Passing an instance of #{seconds.class} to #{self.class}#since is deprecated. This behavior will raise " \
      "a `TypeError` in Rails 8.1."
    )
    result
  end

# File activesupport/lib/active_support/core_ext/time/conversions.rb, line 55
  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