Class: Time

# 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/zones.rb', line 10

attr_accessor :zone_default

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

alias_method :at, :at_with_coercion

# 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 59

alias_method :at_without_coercion, :at

# 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/object/blank.rb', line 192

def blank?
  false
end

# File 'activesupport/lib/active_support/core_ext/object/blank.rb', line 196

def present?
  true
end

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

def system_local_time?
  if ::Time.equal?(self.class)
    zone = self.zone
    String === zone &&
      (zone != "UTC" || active_support_local_zone == "UTC")
  end
end

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

alias_method :-, :minus_with_duration

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

alias_method :<=>, :compare_with_coercion

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

def active_support_local_zone
  @@active_support_local_zone = nil if @@active_support_local_tz != ENV["TZ"]
  @@active_support_local_zone ||=
    begin
      @@active_support_local_tz = ENV["TZ"]
      Time.new.zone
    end
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/object/json.rb', line 201

def as_json(options = nil) # :nodoc:
  if ActiveSupport::JSON::Encoding.use_standard_json_time_format
    xmlschema(ActiveSupport::JSON::Encoding.time_precision)
  else
    %(#{strftime("%Y/%m/%d %H:%M:%S")} #{formatted_offset(false)})
  end
end

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

alias :at_beginning_of_day :beginning_of_day

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

alias :at_beginning_of_hour :beginning_of_hour

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

alias :at_beginning_of_minute :beginning_of_minute

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

alias :at_end_of_day :end_of_day

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

alias :at_end_of_hour :end_of_hour

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

alias :at_end_of_minute :end_of_minute

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

alias :at_midday :middle_of_day

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

alias :at_middle_of_day :middle_of_day

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

alias :at_midnight :beginning_of_day

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

alias :at_noon :middle_of_day

# 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 344

alias_method :compare_without_coercion, :<=>

# 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 355

alias_method :eql?, :eql_with_coercion

# 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/calculations.rb', line 354

alias_method :eql_without_coercion, :eql?

# 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 235

alias :in :since

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

alias :midday :middle_of_day

# 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 241

alias :midnight :beginning_of_day

# 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 307

def minus_with_duration(other) # :nodoc:
  if ActiveSupport::Duration === other
    other.until(self)
  else
    minus_without_duration(other)
  end
end

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

alias_method :minus_without_coercion, :-

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

alias_method :minus_without_duration, :-

# 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 250

alias :noon :middle_of_day

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

def plus_with_duration(other) # :nodoc:
  if ActiveSupport::Duration === other
    other.since(self)
  else
    plus_without_duration(other)
  end
end

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

alias_method :plus_without_duration, :+

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

def preserve_timezone # :nodoc:
  system_local_time? || super
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/conversions.rb', line 74

alias_method :rfc3339, :xmlschema

# 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 62

alias_method :to_formatted_s, :to_fs

# 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