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)
      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)
        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 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 70
    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 183
  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 209
  def ago(seconds)
    since(-seconds)
  end

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

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

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

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 139
  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)
      ::Time.new(new_year, new_month, new_day, new_hour, new_min, new_sec, zone)
    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 313
  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 240
  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 257
  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 273
  def end_of_minute
    change(
      sec: 59,
      usec: Rational(999999999, 1000)
    )
  end

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

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

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

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

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

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

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

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

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

# File activesupport/lib/active_support/core_ext/time/calculations.rb, line 92
  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 101
  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 214
  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_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