Active Support 时区

# File activesupport/lib/active_support/values/time_zone.rb, line 232
def [](arg)
  case arg
  when self
    arg
  when String
    begin
      @lazy_zones_map[arg] ||= create(arg)
    rescue TZInfo::InvalidTimezoneIdentifier
      nil
    end
  when TZInfo::Timezone
    @lazy_zones_map[arg.name] ||= create(arg.name, nil, arg)
  when Numeric, ActiveSupport::Duration
    arg *= 3600 if arg.abs <= 13
    all.find { |z| z.utc_offset == arg.to_i }
  else
    raise ArgumentError, "invalid argument to TimeZone[]: #{arg.inspect}"
  end
end

# File activesupport/lib/active_support/values/time_zone.rb, line 223
def all
  @zones ||= zones_map.values.sort
end

# File activesupport/lib/active_support/values/time_zone.rb, line 260
def country_zones(country_code)
  code = country_code.to_s.upcase
  @country_zones[code] ||= load_country_zones(code)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 207
def find_tzinfo(name)
  TZInfo::Timezone.get(MAPPING[name] || name)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 216
def new(name)
  self[name]
end

# File activesupport/lib/active_support/values/time_zone.rb, line 303
def initialize(name, utc_offset = nil, tzinfo = nil)
  @name = name
  @utc_offset = utc_offset
  @tzinfo = tzinfo || TimeZone.find_tzinfo(name)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 199
def seconds_to_utc_offset(seconds, colon = true)
  format = colon ? UTC_OFFSET_WITH_COLON : UTC_OFFSET_WITHOUT_COLON
  sign = (seconds < 0 ? "-" : "+")
  hours = seconds.abs / 3600
  minutes = (seconds.abs % 3600) / 60
  format % [sign, hours, minutes]
end

# File activesupport/lib/active_support/values/time_zone.rb, line 254
def us_zones
  country_zones(:us)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 326
def <=>(zone)
  return unless zone.respond_to? :utc_offset
  result = (utc_offset <=> zone.utc_offset)
  result = (name <=> zone.name) if result == 0
  result
end

# File activesupport/lib/active_support/values/time_zone.rb, line 335
def =~(re)
  re === name || re === MAPPING[name]
end

# File activesupport/lib/active_support/values/time_zone.rb, line 372
def at(*args)
  Time.at(*args).utc.in_time_zone(self)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 320
def formatted_offset(colon = true, alternate_utc_string = nil)
  utc_offset == 0 && alternate_utc_string || self.class.seconds_to_utc_offset(utc_offset, colon)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 389
def iso8601(str)
  # Historically `Date._iso8601(nil)` returns `{}`, but in the `date` gem versions `3.2.1`, `3.1.2`, `3.0.2`,
  # and `2.0.1`, `Date._iso8601(nil)` raises `TypeError` https://github.com/ruby/date/issues/39
  # Future `date` releases are expected to revert back to the original behavior.
  raise ArgumentError, "invalid date" if str.nil?

  parts = Date._iso8601(str)

  year = parts.fetch(:year)

  if parts.key?(:yday)
    ordinal_date = Date.ordinal(year, parts.fetch(:yday))
    month = ordinal_date.month
    day = ordinal_date.day
  else
    month = parts.fetch(:mon)
    day = parts.fetch(:mday)
  end

  time = Time.new(
    year,
    month,
    day,
    parts.fetch(:hour, 0),
    parts.fetch(:min, 0),
    parts.fetch(:sec, 0) + parts.fetch(:sec_fraction, 0),
    parts.fetch(:offset, 0)
  )

  if parts[:offset]
    TimeWithZone.new(time.utc, self)
  else
    TimeWithZone.new(nil, self, time)
  end

rescue Date::Error, KeyError
  raise ArgumentError, "invalid date"
end

# File activesupport/lib/active_support/values/time_zone.rb, line 356
def local(*args)
  time = Time.utc(*args)
  ActiveSupport::TimeWithZone.new(nil, self, time)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 544
def local_to_utc(time, dst = true)
  tzinfo.local_to_utc(time, dst)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 341
def match?(re)
  (re == name) || (re == MAPPING[name]) ||
    ((Regexp === re) && (re.match?(name) || re.match?(MAPPING[name])))
end

# File activesupport/lib/active_support/values/time_zone.rb, line 509
def now
  time_now.utc.in_time_zone(self)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 446
def parse(str, now = now())
  parts_to_time(Date._parse(str, false), now)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 556
def period_for_local(time, dst = true)
  tzinfo.period_for_local(time, dst) { |periods| periods.last }
end

# File activesupport/lib/active_support/values/time_zone.rb, line 550
def period_for_utc(time)
  tzinfo.period_for_utc(time)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 462
def rfc3339(str)
  parts = Date._rfc3339(str)

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

  time = 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)
  )

  TimeWithZone.new(time.utc, self)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 500
def strptime(str, format, now = now())
  parts_to_time(DateTime._strptime(str, format), now)
end

# File activesupport/lib/active_support/values/time_zone.rb, line 347
def to_s
  "(GMT#{formatted_offset}) #{name}"
end

# File activesupport/lib/active_support/values/time_zone.rb, line 514
def today
  tzinfo.now.to_date
end

# File activesupport/lib/active_support/values/time_zone.rb, line 519
def tomorrow
  today + 1
end

# File activesupport/lib/active_support/values/time_zone.rb, line 310
def utc_offset
  @utc_offset || tzinfo&.current_period&.base_utc_offset
end

# File activesupport/lib/active_support/values/time_zone.rb, line 535
def utc_to_local(time)
  tzinfo.utc_to_local(time).yield_self do |t|
    ActiveSupport.utc_to_local_returns_utc_offset_times ?
      t : Time.utc(t.year, t.month, t.day, t.hour, t.min, t.sec, t.sec_fraction * 1_000_000)
  end
end

# File activesupport/lib/active_support/values/time_zone.rb, line 524
def yesterday
  today - 1
end