danger-packwerk 0.14.0 → 0.14.2

data/sorbet/rbi/gems/tzinfo@2.0.5.rbi

@@ -1,4879 +0,0 @@
-# typed: true
-
-# DO NOT EDIT MANUALLY
-# This is an autogenerated file for types exported from the `tzinfo` gem.
-# Please instead update this file by running `bin/tapioca gem tzinfo`.
-
-# The top level module for TZInfo.
-module TZInfo
-  class << self
-    # Instructs the current {DataSource} to load all timezone and country data
-    # into memory (initializing the {DataSource} first if not previously
-    # accessed or set).
-    #
-    # This may be desirable in production environments to improve copy-on-write
-    # performance and to avoid flushing the constant cache every time a new
-    # timezone or country is loaded from {DataSources::RubyDataSource}.
-    def eager_load!; end
-  end
-end
-
-# Defines transitions that occur on the zero-based nth day of the year.
-#
-# Day 0 is 1 January.
-#
-# Leap days are counted. Day 59 will be 29 February on a leap year and 1 March
-# on a non-leap year. Day 365 will be 31 December on a leap year and 1 January
-# the following year on a non-leap year.
-#
-# @private
-class TZInfo::AbsoluteDayOfYearTransitionRule < ::TZInfo::DayOfYearTransitionRule
-  # Initializes a new {AbsoluteDayOfYearTransitionRule}.
-  #
-  # @param day [Integer] the zero-based day of the year on which the
-  #   transition occurs (0 to 365 inclusive).
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @raise [ArgumentError] if `day` is not an `Integer`.
-  # @raise [ArgumentError] if `day` is less than 0 or greater than 365.
-  # @return [AbsoluteDayOfYearTransitionRule] a new instance of AbsoluteDayOfYearTransitionRule
-  def initialize(day, transition_at = T.unsafe(nil)); end
-
-  # Determines if this {AbsoluteDayOfYearTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {AbsoluteDayOfYearTransitionRule}
-  #   with the same {transition_at} and day as this
-  #   {AbsoluteDayOfYearTransitionRule}, otherwise `false`.
-  def ==(r); end
-
-  # Determines if this {AbsoluteDayOfYearTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {AbsoluteDayOfYearTransitionRule}
-  #   with the same {transition_at} and day as this
-  #   {AbsoluteDayOfYearTransitionRule}, otherwise `false`.
-  def eql?(r); end
-
-  # @return [Boolean] `true` if the day specified by this transition is the
-  #   first in the year (a day number of 0), otherwise `false`.
-  def is_always_first_day_of_year?; end
-
-  # @return [Boolean] `false`.
-  def is_always_last_day_of_year?; end
-
-  protected
-
-  # Returns a `Time` representing midnight local time on the day specified by
-  # the rule for the given offset and year.
-  #
-  # @param offset [TimezoneOffset] the current offset at the time of the
-  #   transition.
-  # @param year [Integer] the year in which the transition occurs.
-  # @return [Time] midnight local time on the day specified by the rule for
-  #   the given offset and year.
-  def get_day(offset, year); end
-
-  # @return [Array] an `Array` of parameters that will influence the output of
-  #   {hash}.
-  def hash_args; end
-end
-
-# {AmbiguousTime} is raised to indicate that a specified local time has more
-# than one possible equivalent UTC time. Such ambiguities arise when the
-# clocks are set back in a time zone, most commonly during the repeated hour
-# when transitioning from daylight savings time to standard time.
-#
-# {AmbiguousTime} is raised by {Timezone#local_datetime},
-# {Timezone#local_time}, {Timezone#local_timestamp}, {Timezone#local_to_utc}
-# and {Timezone#period_for_local} when using an ambiguous time and not
-# specifying how to resolve the ambiguity.
-class TZInfo::AmbiguousTime < ::StandardError; end
-
-# A set of rules that define when transitions occur in time zones with
-# annually occurring daylight savings time.
-#
-# @private
-class TZInfo::AnnualRules
-  # Initializes a new {AnnualRules} instance.
-  #
-  # @param std_offset [TimezoneOffset] the standard offset that applies when
-  #   daylight savings time is not in force.
-  # @param dst_offset [TimezoneOffset] the offset that applies when daylight
-  #   savings time is in force.
-  # @param dst_start_rule [TransitionRule] the rule that determines when
-  #   daylight savings time starts.
-  # @param dst_end_rule [TransitionRule] the rule that determines when daylight
-  #   savings time ends.
-  # @return [AnnualRules] a new instance of AnnualRules
-  def initialize(std_offset, dst_offset, dst_start_rule, dst_end_rule); end
-
-  # @return [TransitionRule] the rule that determines when daylight savings
-  #   time ends.
-  def dst_end_rule; end
-
-  # @return [TimezoneOffset] the offset that applies when daylight savings
-  #   time is in force.
-  def dst_offset; end
-
-  # @return [TransitionRule] the rule that determines when daylight savings
-  #   time starts.
-  def dst_start_rule; end
-
-  # @return [TimezoneOffset] the standard offset that applies when daylight
-  #   savings time is not in force.
-  def std_offset; end
-
-  # Returns the transitions between standard and daylight savings time for a
-  # given year. The results are ordered by time of occurrence (earliest to
-  # latest).
-  #
-  # @param year [Integer] the year to calculate transitions for.
-  # @return [Array<TimezoneTransition>] the transitions for the year.
-  def transitions(year); end
-
-  private
-
-  # Applies a given rule between offsets on a year.
-  #
-  # @param rule [TransitionRule] the rule to apply.
-  # @param from_offset [TimezoneOffset] the offset the rule transitions from.
-  # @param to_offset [TimezoneOffset] the offset the rule transitions to.
-  # @param year [Integer] the year when the transition occurs.
-  # @return [TimezoneTransition] the transition determined by the rule.
-  def apply_rule(rule, from_offset, to_offset, year); end
-end
-
-# A thread-safe version of {StringDeduper}.
-#
-# @private
-class TZInfo::ConcurrentStringDeduper < ::TZInfo::StringDeduper
-  protected
-
-  def create_hash(&block); end
-end
-
-# The {Country} class represents an ISO 3166-1 country. It can be used to
-# obtain a list of time zones observed by a country. For example:
-#
-#     united_states = Country.get('US')
-#     united_states.zone_identifiers
-#     united_states.zones
-#     united_states.zone_info
-#
-# The {Country} class is thread-safe. It is safe to use class and instance
-# methods of {Country} in concurrently executing threads. Instances of
-# {Country} can be shared across thread boundaries.
-#
-# Country information available through TZInfo is intended as an aid for
-# users, to help them select time zone data appropriate for their practical
-# needs. It is not intended to take or endorse any position on legal or
-# territorial claims.
-class TZInfo::Country
-  include ::Comparable
-
-  # Initializes a new {Country} based upon a {DataSources::CountryInfo}
-  # instance.
-  #
-  # {Country} instances should not normally be constructed directly. Use
-  # the {Country.get} method to obtain instances instead.
-  #
-  # @param info [DataSources::CountryInfo] the data to base the new {Country}
-  #   instance upon.
-  # @return [Country] a new instance of Country
-  def initialize(info); end
-
-  # Compares this {Country} with another based on their {code}.
-  #
-  # @param c [Object] an `Object` to compare this {Country} with.
-  # @return [Integer] -1 if `c` is less than `self`, 0 if `c` is equal to
-  #   `self` and +1 if `c` is greater than `self`, or `nil` if `c` is not an
-  #   instance of {Country}.
-  def <=>(c); end
-
-  # Matches `regexp` against the {code} of this {Country}.
-  #
-  # @param regexp [Regexp] a `Regexp` to match against the {code} of
-  #   this {Country}.
-  # @return [Integer] the position the match starts, or `nil` if there is no
-  #   match.
-  def =~(regexp); end
-
-  # Returns a serialized representation of this {Country}. This method is
-  # called when using `Marshal.dump` with an instance of {Country}.
-  #
-  # @param limit [Integer] the maximum depth to dump - ignored.
-  # @return [String] a serialized representation of this {Country}.
-  def _dump(limit); end
-
-  # @return [String] the ISO 3166-1 alpha-2 country code.
-  def code; end
-
-  # @param c [Object] an `Object` to compare this {Country} with.
-  # @return [Boolean] `true` if `c` is an instance of {Country} and has the
-  #   same code as `self`, otherwise `false`.
-  def eql?(c); end
-
-  # @return [Integer] a hash based on the {code}.
-  def hash; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # @return [String] the name of the country.
-  def name; end
-
-  # @return [String] a `String` representation of this {Country} (the name of
-  #   the country).
-  def to_s; end
-
-  # Returns an `Array` containing the identifier for each time zone observed
-  # by the country. These are in an order that
-  #
-  # 1. makes some geographical sense, and
-  # 2. puts the most populous zones first, where that does not contradict 1.
-  #
-  # Returned zone identifiers may refer to cities and regions outside of the
-  # country. This will occur if the zone covers multiple countries. Any zones
-  # referring to a city or region in a different country will be listed after
-  # those relating to this country.
-  #
-  # @return [Array<String>] an `Array` containing the identifier for each time
-  #   zone observed by the country
-  def zone_identifiers; end
-
-  # Returns a frozen `Array` containing a {CountryTimezone} instance for each
-  # time zone observed by the country. These are in an order that
-  #
-  # 1. makes some geographical sense, and
-  # 2. puts the most populous zones first, where that does not contradict 1.
-  #
-  # The {CountryTimezone} instances can be used to obtain the location and
-  # descriptions of the observed time zones.
-  #
-  # Identifiers and descriptions of the time zones returned may refer to
-  # cities and regions outside of the country. This will occur if the time
-  # zone covers multiple countries. Any zones referring to a city or region in
-  # a different country will be listed after those relating to this country.
-  #
-  # @return [Array<CountryTimezone>] a frozen `Array` containing a
-  #   {CountryTimezone} instance for each time zone observed by the country.
-  def zone_info; end
-
-  # Returns an `Array` containing the identifier for each time zone observed
-  # by the country. These are in an order that
-  #
-  # 1. makes some geographical sense, and
-  # 2. puts the most populous zones first, where that does not contradict 1.
-  #
-  # Returned zone identifiers may refer to cities and regions outside of the
-  # country. This will occur if the zone covers multiple countries. Any zones
-  # referring to a city or region in a different country will be listed after
-  # those relating to this country.
-  #
-  # @return [Array<String>] an `Array` containing the identifier for each time
-  #   zone observed by the country
-  def zone_names; end
-
-  # Returns An `Array` containing a {Timezone} instance for each time zone
-  # observed by the country. These are in an order that
-  #
-  # 1. makes some geographical sense, and
-  # 2. puts the most populous zones first, where that does not contradict 1.
-  #
-  # The identifiers of the time zones returned may refer to cities and regions
-  # outside of the country. This will occur if the time zone covers multiple
-  # countries. Any zones referring to a city or region in a different country
-  # will be listed after those relating to this country.
-  #
-  # The results are actually instances of {TimezoneProxy} in order to defer
-  # loading of the time zone transition data until it is first needed.
-  #
-  # @return [Array<Timezone>] an `Array` containing a {Timezone} instance for
-  #   each time zone observed by the country.
-  def zones; end
-
-  class << self
-    # Loads a {Country} from the serialized representation returned by {_dump}.
-    # This is method is called when using `Marshal.load` or `Marshal.restore`
-    # to restore a serialized {Country}.
-    #
-    # @param data [String] a serialized representation of a {Country}.
-    # @return [Country] the result of converting `data` back into a {Country}.
-    def _load(data); end
-
-    # @return [Array<Country>] an `Array` containing one {Country} instance
-    #   for each defined country.
-    def all; end
-
-    # @return [Array<String>] an `Array` containing all the valid ISO 3166-1
-    #   alpha-2 country codes.
-    def all_codes; end
-
-    # Gets a {Country} by its ISO 3166-1 alpha-2 code.
-    #
-    # The {Country.all_codes} method can be used to obtain a list of valid ISO
-    # 3166-1 alpha-2 codes.
-    #
-    # @param code [String] An ISO 3166-1 alpha-2 code.
-    # @raise [InvalidCountryCode] If {code} is not a valid ISO 3166-1 alpha-2
-    #   code it couldn't be found.
-    # @return [Country] a {Country} instance representing the ISO-3166-1
-    #   country identified by the `code` parameter.
-    def get(code); end
-
-    private
-
-    # @return [DataSource] the current DataSource.
-    def data_source; end
-  end
-end
-
-# Alias used by TZInfo::Data format1 releases.
-#
-# @private
-TZInfo::CountryIndexDefinition = TZInfo::Format1::CountryIndexDefinition
-
-# Information about a time zone used by a {Country}.
-class TZInfo::CountryTimezone
-  # Creates a new {CountryTimezone}.
-  #
-  # The passed in identifier and description instances will be frozen.
-  #
-  # {CountryTimezone} instances should normally only be constructed
-  # by implementations of {DataSource}.
-  #
-  # @param identifier [String] the {Timezone} identifier.
-  # @param latitude [Rational] the latitude of the time zone.
-  # @param longitude [Rational] the longitude of the time zone.
-  # @param description [String] an optional description of the time zone.
-  # @return [CountryTimezone] a new instance of CountryTimezone
-  def initialize(identifier, latitude, longitude, description = T.unsafe(nil)); end
-
-  # Tests if the given object is equal to the current instance (has the same
-  # identifier, latitude, longitude and description).
-  #
-  # @param ct [Object] the object to be compared.
-  # @return [TrueClass] `true` if `ct` is equal to the current instance.
-  def ==(ct); end
-
-  # A description of this time zone in relation to the country, e.g. "Eastern
-  # Time". This is usually `nil` for countries that have a single time zone.
-  #
-  # @return [String] an optional description of the time zone.
-  def description; end
-
-  # @return [String] the {description} if present, otherwise a human-readable
-  #   representation of the identifier (using {Timezone#friendly_identifier}).
-  def description_or_friendly_identifier; end
-
-  # Tests if the given object is equal to the current instance (has the same
-  # identifier, latitude, longitude and description).
-  #
-  # @param ct [Object] the object to be compared.
-  # @return [Boolean] `true` if `ct` is equal to the current instance.
-  def eql?(ct); end
-
-  # {longitude} and {description}.
-  #
-  # @return [Integer] a hash based on the {identifier}, {latitude},
-  def hash; end
-
-  # @return [String] the identifier of the {Timezone} being described.
-  def identifier; end
-
-  # The latitude of this time zone in degrees. Positive numbers are degrees
-  # north and negative numbers are degrees south.
-  #
-  # Note that depending on the data source, the position given by {#latitude}
-  # and {#longitude} may not be within the country.
-  #
-  # @return [Rational] the latitude in degrees.
-  def latitude; end
-
-  # The longitude of this time zone in degrees. Positive numbers are degrees
-  # east and negative numbers are degrees west.
-  #
-  # Note that depending on the data source, the position given by {#latitude}
-  # and {#longitude} may not be within the country.
-  #
-  # @return [Rational] the longitude in degrees.
-  def longitude; end
-
-  # Returns the associated {Timezone}.
-  #
-  # The result is actually an instance of {TimezoneProxy} in order to defer
-  # loading of the time zone transition data until it is first needed.
-  #
-  # @return [Timezone] the associated {Timezone}.
-  def timezone; end
-end
-
-# TZInfo can be used with different data sources for time zone and country
-# data. Each source of data is implemented as a subclass of {DataSource}.
-#
-# To choose a data source and override the default selection, use the
-# {DataSource.set} method.
-#
-# @abstract To create a custom data source, create a subclass of {DataSource}
-#   and implement the {load_timezone_info}, {data_timezone_identifiers},
-#   {linked_timezone_identifiers}, {load_country_info} and {country_codes}
-#   methods.
-class TZInfo::DataSource
-  # Initializes a new {DataSource} instance. Typically only called via
-  # subclasses of {DataSource}.
-  #
-  # @return [DataSource] a new instance of DataSource
-  def initialize; end
-
-  # Returns a frozen `Array` of all the available ISO 3166-1 alpha-2 country
-  # codes. The identifiers are sorted according to `String#<=>`.
-  #
-  # @return [Array<String>] a frozen `Array` of all the available ISO 3166-1
-  #   alpha-2 country codes.
-  def country_codes; end
-
-  # Returns a frozen `Array` of all the available time zone identifiers for
-  # data time zones (i.e. those that actually contain definitions). The
-  # identifiers are sorted according to `String#<=>`.
-  #
-  # @return [Array<String>] a frozen `Array` of all the available time zone
-  #   identifiers for data time zones.
-  def data_timezone_identifiers; end
-
-  # Loads all timezone and country data into memory.
-  #
-  # This may be desirable in production environments to improve copy-on-write
-  # performance and to avoid flushing the constant cache every time a new
-  # timezone or country is loaded from {DataSources::RubyDataSource}.
-  def eager_load!; end
-
-  # @param code [String] an ISO 3166-1 alpha-2 country code.
-  # @raise [InvalidCountryCode] if the country could not be found or the code
-  #   is invalid.
-  # @return [DataSources::CountryInfo] a {DataSources::CountryInfo} instance
-  #   for the given ISO 3166-1 alpha-2 country code.
-  def get_country_info(code); end
-
-  # Returns a {DataSources::TimezoneInfo} instance for the given identifier.
-  # The result will derive from either {DataSources::DataTimezoneInfo} for
-  # time zones that define their own data or {DataSources::LinkedTimezoneInfo}
-  # for links or aliases to other time zones.
-  #
-  # {get_timezone_info} calls {load_timezone_info} to create the
-  # {DataSources::TimezoneInfo} instance. The returned instance is cached and
-  # returned in subsequent calls to {get_timezone_info} for the identifier.
-  #
-  # @param identifier [String] A time zone identifier.
-  # @raise [InvalidTimezoneIdentifier] if the time zone is not found or the
-  #   identifier is invalid.
-  # @return [DataSources::TimezoneInfo] a {DataSources::TimezoneInfo} instance
-  #   for a given identifier.
-  def get_timezone_info(identifier); end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # Returns a frozen `Array` of all the available time zone identifiers that
-  # are links to other time zones. The identifiers are sorted according to
-  # `String#<=>`.
-  #
-  # @return [Array<String>] a frozen `Array` of all the available time zone
-  #   identifiers that are links to other time zones.
-  def linked_timezone_identifiers; end
-
-  # @return [Array<String>] a frozen `Array`` of all the available time zone
-  #   identifiers. The identifiers are sorted according to `String#<=>`.
-  def timezone_identifiers; end
-
-  # @return [String] a description of the {DataSource}.
-  def to_s; end
-
-  protected
-
-  # @param code [String] an ISO 3166-1 alpha-2 country code.
-  # @raise [InvalidCountryCode] if the country could not be found or the code
-  #   is invalid.
-  # @return [DataSources::CountryInfo] a {DataSources::CountryInfo} instance
-  #   for the given ISO 3166-1 alpha-2 country code.
-  def load_country_info(code); end
-
-  # Returns a {DataSources::TimezoneInfo} instance for the given time zone
-  # identifier. The result should derive from either
-  # {DataSources::DataTimezoneInfo} for time zones that define their own data
-  # or {DataSources::LinkedTimezoneInfo} for links to or aliases for other
-  # time zones.
-  #
-  # @param identifier [String] A time zone identifier.
-  # @raise [InvalidTimezoneIdentifier] if the time zone is not found or the
-  #   identifier is invalid.
-  # @return [DataSources::TimezoneInfo] a {DataSources::TimezoneInfo} instance
-  #   for the given time zone identifier.
-  def load_timezone_info(identifier); end
-
-  # Looks up a given code in the given hash of code to
-  # {DataSources::CountryInfo} mappings. If the code is found the
-  # {DataSources::CountryInfo} is returned. Otherwise an {InvalidCountryCode}
-  # exception is raised.
-  #
-  # @param hash [String, DataSources::CountryInfo] a mapping from ISO 3166-1
-  #   alpha-2 country codes to {DataSources::CountryInfo} instances.
-  # @param code [String] a country code to lookup.
-  # @param encoding [Encoding] the encoding used for the country codes in
-  #   `hash`.
-  # @raise [InvalidCountryCode] if `code` was not found in `hash`.
-  # @return [DataSources::CountryInfo] the {DataSources::CountryInfo} instance
-  #   corresponding to `code`.
-  def lookup_country_info(hash, code, encoding = T.unsafe(nil)); end
-
-  # @return [Encoding] the `Encoding` used by the `String` instances returned
-  #   by {data_timezone_identifiers} and {linked_timezone_identifiers}.
-  def timezone_identifier_encoding; end
-
-  # Checks that the given identifier is a valid time zone identifier (can be
-  # found in the {timezone_identifiers} `Array`). If the identifier is valid,
-  # the `String` instance representing that identifier from
-  # `timezone_identifiers` is returned. Otherwise an
-  # {InvalidTimezoneIdentifier} exception is raised.
-  #
-  # @param identifier [String] a time zone identifier to be validated.
-  # @raise [InvalidTimezoneIdentifier] if `identifier` was not found in
-  #   {timezone_identifiers}.
-  # @return [String] the `String` instance equivalent to `identifier` from
-  #   {timezone_identifiers}.
-  def validate_timezone_identifier(identifier); end
-
-  private
-
-  # Combines {data_timezone_identifiers} and {linked_timezone_identifiers}
-  # to create an `Array` containing all valid time zone identifiers. If
-  # {linked_timezone_identifiers} is empty, the {data_timezone_identifiers}
-  # instance is returned.
-  #
-  # The returned `Array` is frozen. The identifiers are sorted according to
-  # `String#<=>`.
-  #
-  # @return [Array<String>] an `Array` containing all valid time zone
-  #   identifiers.
-  def build_timezone_identifiers; end
-
-  # If the given `identifier` is contained within the {timezone_identifiers}
-  # `Array`, the `String` instance representing that identifier from
-  # {timezone_identifiers} is returned. Otherwise, `nil` is returned.
-  #
-  # :nocov_array_bsearch:
-  #
-  # @param identifier [String] A time zone identifier to search for.
-  # @return [String] the `String` instance representing `identifier` from
-  #   {timezone_identifiers} if found, or `nil` if not found.
-  def find_timezone_identifier(identifier); end
-
-  # Raises {InvalidDataSource} to indicate that a method has not been
-  # overridden by a particular data source implementation.
-  #
-  # @raise [InvalidDataSource] always.
-  def raise_invalid_data_source(method_name); end
-
-  # Tries an operation using `string` directly. If the operation fails, the
-  # string is copied and encoded with `encoding` and the operation is tried
-  # again.
-  #
-  # fails and `string` is already encoded with `encoding`.
-  #
-  # @param string [String] The `String` to perform the operation on.
-  # @param encoding [Encoding] The `Encoding` to use if the initial attempt
-  #   fails.
-  # @return [Object] the result of the operation or `nil` if the first attempt
-  # @yield [s] the caller will be yielded to once or twice to attempt the
-  #   operation.
-  # @yieldparam s [String] either `string` or an encoded copy of `string`.
-  # @yieldreturn [Object] The result of the operation. Must be truthy if
-  #   successful.
-  def try_with_encoding(string, encoding); end
-
-  class << self
-    # @return [DataSource] the currently selected source of data.
-    def get; end
-
-    # Sets the currently selected data source for time zone and country data.
-    #
-    # This should usually be set to one of the two standard data source types:
-    #
-    # * `:ruby` - read data from the Ruby modules included in the TZInfo::Data
-    #   library (tzinfo-data gem).
-    # * `:zoneinfo` - read data from the zoneinfo files included with most
-    #   Unix-like operating systems (e.g. in /usr/share/zoneinfo).
-    #
-    # To set TZInfo to use one of the standard data source types, call
-    # `TZInfo::DataSource.set`` in one of the following ways:
-    #
-    #     TZInfo::DataSource.set(:ruby)
-    #     TZInfo::DataSource.set(:zoneinfo)
-    #     TZInfo::DataSource.set(:zoneinfo, zoneinfo_dir)
-    #     TZInfo::DataSource.set(:zoneinfo, zoneinfo_dir, iso3166_tab_file)
-    #
-    # `DataSource.set(:zoneinfo)` will automatically search for the zoneinfo
-    # directory by checking the paths specified in
-    # {DataSources::ZoneinfoDataSource.search_path}.
-    # {DataSources::ZoneinfoDirectoryNotFound} will be raised if no valid
-    # zoneinfo directory could be found.
-    #
-    # `DataSource.set(:zoneinfo, zoneinfo_dir)` uses the specified
-    # `zoneinfo_dir` directory as the data source. If the directory is not a
-    # valid zoneinfo directory, a {DataSources::InvalidZoneinfoDirectory}
-    # exception will be raised.
-    #
-    # `DataSource.set(:zoneinfo, zoneinfo_dir, iso3166_tab_file)` uses the
-    # specified `zoneinfo_dir` directory as the data source, but loads the
-    # `iso3166.tab` file from the path given by `iso3166_tab_file`. If the
-    # directory is not a valid zoneinfo directory, a
-    # {DataSources::InvalidZoneinfoDirectory} exception will be raised.
-    #
-    # Custom data sources can be created by subclassing TZInfo::DataSource and
-    # implementing the following methods:
-    #
-    # * {load_timezone_info}
-    # * {data_timezone_identifiers}
-    # * {linked_timezone_identifiers}
-    # * {load_country_info}
-    # * {country_codes}
-    #
-    # To have TZInfo use the custom data source, call {DataSource.set},
-    # passing an instance of the custom data source implementation as follows:
-    #
-    #     TZInfo::DataSource.set(CustomDataSource.new)
-    #
-    # Calling {DataSource.set} will only affect instances of {Timezone} and
-    # {Country} obtained with {Timezone.get} and {Country.get} subsequent to
-    # the {DataSource.set} call. Existing {Timezone} and {Country} instances
-    # will be unaffected.
-    #
-    # If {DataSource.set} is not called, TZInfo will by default attempt to use
-    # TZInfo::Data as the data source. If TZInfo::Data is not available (i.e.
-    # if `require 'tzinfo/data'` fails), then TZInfo will search for a
-    # zoneinfo directory instead (using the search path specified by
-    # {DataSources::ZoneinfoDataSource.search_path}).
-    #
-    # @param data_source_or_type [Object] either `:ruby`, `:zoneinfo` or an
-    #   instance of a {DataSource}.
-    # @param args [Array<Object>] when `data_source_or_type` is a symbol,
-    #   optional arguments to use when initializing the data source.
-    # @raise [ArgumentError] if `data_source_or_type` is not `:ruby`,
-    #   `:zoneinfo` or an instance of {DataSource}.
-    def set(data_source_or_type, *args); end
-
-    private
-
-    # Creates a {DataSource} instance for use as the default. Used if no
-    # preference has been specified manually.
-    #
-    # @return [DataSource] the newly created default {DataSource} instance.
-    def create_default_data_source; end
-  end
-end
-
-# {DataSourceNotFound} is raised if no data source could be found (i.e. if
-# `'tzinfo/data'` cannot be found on the load path and no valid zoneinfo
-# directory can be found on the system).
-class TZInfo::DataSourceNotFound < ::StandardError; end
-
-# {DataSource} implementations and classes used by {DataSource}
-# implementations.
-module TZInfo::DataSources; end
-
-# Represents a data time zone defined by a constantly observed offset.
-class TZInfo::DataSources::ConstantOffsetDataTimezoneInfo < ::TZInfo::DataSources::DataTimezoneInfo
-  # Initializes a new {ConstantOffsetDataTimezoneInfo}.
-  #
-  # The passed in `identifier` instance will be frozen. A reference to the
-  # passed in {TimezoneOffset} will be retained.
-  #
-  # @param identifier [String] the identifier of the time zone.
-  # @param constant_offset [TimezoneOffset] the constantly observed offset.
-  # @raise [ArgumentError] if `identifier` or `constant_offset` is `nil`.
-  # @return [ConstantOffsetDataTimezoneInfo] a new instance of ConstantOffsetDataTimezoneInfo
-  def initialize(identifier, constant_offset); end
-
-  # @return [TimezoneOffset] the offset that is constantly observed.
-  def constant_offset; end
-
-  # @param timestamp [Timestamp] ignored.
-  # @return [TimezonePeriod] an unbounded {TimezonePeriod} for the time
-  #   zone's constantly observed offset.
-  def period_for(timestamp); end
-
-  # @param local_timestamp [Timestamp] ignored.
-  # @return [Array<TimezonePeriod>] an `Array` containing a single unbounded
-  #   {TimezonePeriod} for the time zone's constantly observed offset.
-  def periods_for_local(local_timestamp); end
-
-  # @param to_timestamp [Timestamp] ignored.
-  # @param from_timestamp [Timestamp] ignored.
-  # @return [Array] an empty `Array`, since there are no transitions in time
-  #   zones that observe a constant offset.
-  def transitions_up_to(to_timestamp, from_timestamp = T.unsafe(nil)); end
-
-  private
-
-  # @return [TimezonePeriod] an unbounded {TimezonePeriod} with the constant
-  #   offset of this timezone.
-  def constant_period; end
-end
-
-# Represents a country and references to its time zones as returned by a
-# {DataSource}.
-class TZInfo::DataSources::CountryInfo
-  # Initializes a new {CountryInfo}. The passed in `code`, `name` and
-  # `zones` instances will be frozen.
-  #
-  # @param code [String] an ISO 3166-1 alpha-2 country code.
-  # @param name [String] the name of the country.
-  # @param zones [Array<CountryTimezone>] the time zones observed in the
-  #   country.
-  # @raise [ArgumentError] if `code`, `name` or `zones` is `nil`.
-  # @return [CountryInfo] a new instance of CountryInfo
-  def initialize(code, name, zones); end
-
-  # @return [String] the ISO 3166-1 alpha-2 country code.
-  def code; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # @return [String] the name of the country.
-  def name; end
-
-  # @return [Array<CountryTimezone>] the time zones observed in the country.
-  def zones; end
-end
-
-# The base class for time zones defined as either a series of transitions
-# ({TransitionsDataTimezoneInfo}) or a constantly observed offset
-# ({ConstantOffsetDataTimezoneInfo}).
-#
-# @abstract Data sources return instances of {DataTimezoneInfo} subclasses.
-class TZInfo::DataSources::DataTimezoneInfo < ::TZInfo::DataSources::TimezoneInfo
-  # @return [DataTimezone] a new {DataTimezone} instance for the time zone
-  #   represented by this {DataTimezoneInfo}.
-  def create_timezone; end
-
-  # @param timestamp [Timestamp] a {Timestamp} with a specified
-  #   {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `timestamp` is `nil` or does not
-  #   have a specified {Timestamp#utc_offset utc_offset}.
-  # @return [TimezonePeriod] the {TimezonePeriod} observed at the time
-  #   specified by `timestamp`.
-  def period_for(timestamp); end
-
-  # Returns an `Array` containing the {TimezonePeriod TimezonePeriods} that
-  # could be observed at the local time specified by `local_timestamp`. The
-  # results are are ordered by increasing UTC start date. An empty `Array`
-  # is returned if no periods are found for the given local time.
-  #
-  # @param local_timestamp [Timestamp] a {Timestamp} representing a local
-  #   time - must have an unspecified {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `local_timestamp` is `nil`, or
-  #   has a specified {Timestamp#utc_offset utc_offset}.
-  # @return [Array<TimezonePeriod>] an `Array` containing the
-  #   {TimezonePeriod TimezonePeriods} that could be observed at the local
-  #   time specified by `local_timestamp`.
-  def periods_for_local(local_timestamp); end
-
-  # Returns an `Array` of {TimezoneTransition} instances representing the
-  # times where the UTC offset of the time zone changes.
-  #
-  # Transitions are returned up to a given {Timestamp} (`to_timestamp`).
-  #
-  # A from {Timestamp} may also be supplied using the `from_timestamp`
-  # parameter. If `from_timestamp` is specified, only transitions from that
-  # time onwards will be returned.
-  #
-  # Comparisons with `to_timestamp` are exclusive. Comparisons with
-  # `from_timestamp` are inclusive. If a transition falls precisely on
-  # `to_timestamp`, it will be excluded. If a transition falls on
-  # `from_timestamp`, it will be included.
-  #
-  # Transitions returned are ordered by when they occur, from earliest to
-  # latest.
-  #
-  # @param to_timestamp [Timestamp] a {Timestamp} with a specified
-  #   {Timestamp#utc_offset utc_offset}. Transitions are returned if they
-  #   occur before this time.
-  # @param from_timestamp [Timestamp] an optional {Timestamp} with a
-  #   specified {Timestamp#utc_offset utc_offset}. If specified, transitions
-  #   are returned if they occur at or after this time.
-  # @raise [ArgumentError] may be raised if `to_timestamp` is `nil` or does
-  #   not have a specified {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `from_timestamp` is specified
-  #   but does not have a specified {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `from_timestamp` is specified
-  #   but is not earlier than or at the same time as `to_timestamp`.
-  # @return [Array<TimezoneTransition>] an `Array` of {TimezoneTransition}
-  #   instances representing the times where the UTC offset of the time zone
-  #   changes.
-  def transitions_up_to(to_timestamp, from_timestamp = T.unsafe(nil)); end
-
-  private
-
-  # Raises a {NotImplementedError} to indicate that the base class is
-  # incorrectly being used directly.
-  #
-  # raise [NotImplementedError] always.
-  #
-  # @raise [NotImplementedError]
-  def raise_not_implemented(method_name); end
-end
-
-# An {InvalidPosixTimeZone} exception is raised if an invalid POSIX-style
-# time zone string is encountered.
-#
-# @private
-class TZInfo::DataSources::InvalidPosixTimeZone < ::StandardError; end
-
-# An {InvalidZoneinfoDirectory} exception is raised if {ZoneinfoDataSource}
-# is initialized with a specific zoneinfo path that is not a valid zoneinfo
-# directory. A valid zoneinfo directory is one that contains time zone
-# files, a country code index file named iso3166.tab and a time zone index
-# file named zone1970.tab or zone.tab.
-class TZInfo::DataSources::InvalidZoneinfoDirectory < ::StandardError; end
-
-# An {InvalidZoneinfoFile} exception is raised if an attempt is made to load
-# an invalid zoneinfo file.
-class TZInfo::DataSources::InvalidZoneinfoFile < ::StandardError; end
-
-# Represents a time zone that is defined as a link to or alias of another
-# zone.
-class TZInfo::DataSources::LinkedTimezoneInfo < ::TZInfo::DataSources::TimezoneInfo
-  # Initializes a new {LinkedTimezoneInfo}. The passed in `identifier` and
-  # `link_to_identifier` instances will be frozen.
-  #
-  # `nil`.
-  #
-  # @param identifier [String] the identifier of the time zone.
-  # @param link_to_identifier [String] the identifier of the time zone that
-  #   this zone link to.
-  # @raise [ArgumentError] if `identifier` or `link_to_identifier` are
-  # @return [LinkedTimezoneInfo] a new instance of LinkedTimezoneInfo
-  def initialize(identifier, link_to_identifier); end
-
-  # @return [LinkedTimezone] a new {LinkedTimezone} instance for the time
-  #   zone represented by this {LinkedTimezoneInfo}.
-  def create_timezone; end
-
-  # (that this zone links to or is an alias for).
-  #
-  # @return [String] the identifier of the time zone that provides the data
-  def link_to_identifier; end
-end
-
-# A parser for POSIX-style TZ strings used in zoneinfo files and specified
-# by tzfile.5 and tzset.3.
-#
-# @private
-class TZInfo::DataSources::PosixTimeZoneParser
-  # Initializes a new {PosixTimeZoneParser}.
-  #
-  # @param string_deduper [StringDeduper] a {StringDeduper} instance to use
-  #   to dedupe abbreviations.
-  # @return [PosixTimeZoneParser] a new instance of PosixTimeZoneParser
-  def initialize(string_deduper); end
-
-  # Parses a POSIX-style TZ string.
-  #
-  # @param tz_string [String] the string to parse.
-  # @raise [InvalidPosixTimeZone] if `tz_string` is not a `String`.
-  # @raise [InvalidPosixTimeZone] if `tz_string` is is not valid.
-  # @return [Object] either a {TimezoneOffset} for a constantly applied
-  #   offset or an {AnnualRules} instance representing the rules.
-  def parse(tz_string); end
-
-  private
-
-  # Scans for a pattern and raises an exception if the pattern does not
-  # match the input.
-  #
-  # @param s [StringScanner] the `StringScanner` to scan.
-  # @param pattern [Regexp] the pattern to match.
-  # @raise [InvalidPosixTimeZone] if the pattern does not match the input.
-  # @return [String] the result of the scan.
-  def check_scan(s, pattern); end
-
-  # Returns an offset in seconds from hh:mm:ss values. The value can be
-  # negative. -02:33:12 would represent 2 hours, 33 minutes and 12 seconds
-  # ahead of UTC.
-  #
-  # @param h [String] the hours.
-  # @param m [String] the minutes.
-  # @param s [String] the seconds.
-  # @raise [InvalidPosixTimeZone] if the mm and ss values are greater than
-  #   59.
-  # @return [Integer] the offset.
-  def get_offset_from_hms(h, m, s); end
-
-  # Returns the seconds from midnight from hh:mm:ss values. Hours can exceed
-  # 24 for a time on the following day. Hours can be negative to subtract
-  # hours from midnight on the given day. -02:33:12 represents 22:33:12 on
-  # the prior day.
-  #
-  # @param h [String] the hour.
-  # @param m [String] the minutes past the hour.
-  # @param s [String] the seconds past the minute.
-  # @raise [InvalidPosixTimeZone] if the mm and ss values are greater than
-  #   59.
-  # @return [Integer] the number of seconds after midnight.
-  def get_seconds_after_midnight_from_hms(h, m, s); end
-
-  # Parses a rule.
-  #
-  # @param s [StringScanner] the `StringScanner` to read the rule from.
-  # @param type [String] the type of rule (either `'start'` or `'end'`).
-  # @raise [InvalidPosixTimeZone] if the rule is not valid.
-  # @return [TransitionRule] the parsed rule.
-  def parse_rule(s, type); end
-end
-
-# A DataSource implementation that loads data from the set of Ruby modules
-# included in the tzinfo-data gem.
-#
-# TZInfo will use {RubyDataSource} by default if the tzinfo-data gem
-# is available on the load path. It can also be selected by calling
-# {DataSource.set} as follows:
-#
-#     TZInfo::DataSource.set(:ruby)
-class TZInfo::DataSources::RubyDataSource < ::TZInfo::DataSource
-  # Initializes a new {RubyDataSource} instance.
-  #
-  # @raise [TZInfoDataNotFound] if the tzinfo-data gem could not be found
-  #   (i.e. `require 'tzinfo/data'` failed).
-  # @return [RubyDataSource] a new instance of RubyDataSource
-  def initialize; end
-
-  # Returns the value of attribute country_codes.
-  def country_codes; end
-
-  # Returns the value of attribute data_timezone_identifiers.
-  def data_timezone_identifiers; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # Returns the value of attribute linked_timezone_identifiers.
-  def linked_timezone_identifiers; end
-
-  # @return [String] a description of the {DataSource}.
-  def to_s; end
-
-  protected
-
-  # @param code [String] an ISO 3166-1 alpha-2 country code.
-  # @raise [InvalidCountryCode] if the country could not be found or the code
-  #   is invalid.
-  # @return [DataSources::CountryInfo] a {DataSources::CountryInfo} instance
-  #   for the given ISO 3166-1 alpha-2 country code.
-  def load_country_info(code); end
-
-  # Returns a {TimezoneInfo} instance for the given time zone identifier.
-  # The result will either be a {ConstantOffsetDataTimezoneInfo}, a
-  # {TransitionsDataTimezoneInfo} or a {LinkedTimezoneInfo} depending on the
-  # type of time zone.
-  #
-  # @param identifier [String] A time zone identifier.
-  # @raise [InvalidTimezoneIdentifier] if the time zone is not found or the
-  #   identifier is invalid.
-  # @return [TimezoneInfo] a {TimezoneInfo} instance for the given time zone
-  #   identifier.
-  def load_timezone_info(identifier); end
-
-  private
-
-  # Requires a file from tzinfo/data.
-  #
-  # @param file [Array<String>] a relative path to a file to be required.
-  def require_data(*file); end
-
-  # Requires a zone definition by its identifier (split on /).
-  #
-  # @param identifier [Array<string>] the component parts of a time zone
-  #   identifier (split on /). This must have already been validated.
-  def require_definition(identifier); end
-
-  # Requires an index by its name.
-  #
-  # @param name [String] an index name.
-  def require_index(name); end
-
-  # @return [String] a `String` containing TZInfo::Data version infomation
-  #   for inclusion in the #to_s and #inspect output.
-  def version_info; end
-end
-
-# A {TZInfoDataNotFound} exception is raised if the tzinfo-data gem could
-# not be found (i.e. `require 'tzinfo/data'` failed) when selecting the Ruby
-# data source.
-class TZInfo::DataSources::TZInfoDataNotFound < ::StandardError; end
-
-# Represents a time zone defined by a data source.
-#
-# @abstract Data sources return instances of {TimezoneInfo} subclasses.
-class TZInfo::DataSources::TimezoneInfo
-  # Initializes a new TimezoneInfo. The passed in `identifier` instance will
-  # be frozen.
-  #
-  # @param identifier [String] the identifier of the time zone.
-  # @raise [ArgumentError] if `identifier` is `nil`.
-  # @return [TimezoneInfo] a new instance of TimezoneInfo
-  def initialize(identifier); end
-
-  # @return [Timezone] a new {Timezone} instance for the time zone
-  #   represented by this {TimezoneInfo}.
-  def create_timezone; end
-
-  # @return [String] the identifier of the time zone.
-  def identifier; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  private
-
-  # Raises a {NotImplementedError}.
-  #
-  # @param method_name [String] the name of the method that must be
-  #   overridden.
-  # @raise NotImplementedError always.
-  def raise_not_implemented(method_name); end
-end
-
-# Represents a data time zone defined by a list of transitions that change
-# the locally observed time.
-class TZInfo::DataSources::TransitionsDataTimezoneInfo < ::TZInfo::DataSources::DataTimezoneInfo
-  # Initializes a new {TransitionsDataTimezoneInfo}.
-  #
-  # The passed in `identifier` instance will be frozen. A reference to the
-  # passed in `Array` will be retained.
-  #
-  # The `transitions` `Array` must be sorted in order of ascending
-  # timestamp. Each transition must have a
-  # {TimezoneTransition#timestamp_value timestamp_value} that is greater
-  # than the {TimezoneTransition#timestamp_value timestamp_value} of the
-  # prior transition.
-  #
-  # @param identifier [String] the identifier of the time zone.
-  # @param transitions [Array<TimezoneTransitions>] an `Array` of
-  #   transitions that each indicate when a change occurs in the locally
-  #   observed time.
-  # @raise [ArgumentError] if `identifier` is `nil`.
-  # @raise [ArgumentError] if `transitions` is `nil`.
-  # @raise [ArgumentError] if `transitions` is an empty `Array`.
-  # @return [TransitionsDataTimezoneInfo] a new instance of TransitionsDataTimezoneInfo
-  def initialize(identifier, transitions); end
-
-  # @param timestamp [Timestamp] a {Timestamp} with a specified
-  #   {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `timestamp` is `nil` or does not
-  #   have a specified {Timestamp#utc_offset utc_offset}.
-  # @return [TimezonePeriod] the {TimezonePeriod} observed at the time
-  #   specified by `timestamp`.
-  def period_for(timestamp); end
-
-  # Returns an `Array` containing the {TimezonePeriod TimezonePeriods} that
-  # could be observed at the local time specified by `local_timestamp`. The
-  # results are are ordered by increasing UTC start date. An empty `Array`
-  # is returned if no periods are found for the given local time.
-  #
-  # @param local_timestamp [Timestamp] a {Timestamp} representing a local
-  #   time - must have an unspecified {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `local_timestamp` is `nil`, or
-  #   has a specified {Timestamp#utc_offset utc_offset}.
-  # @return [Array<TimezonePeriod>] an `Array` containing the
-  #   {TimezonePeriod TimezonePeriods} that could be observed at the local
-  #   time specified by `local_timestamp`.
-  def periods_for_local(local_timestamp); end
-
-  # @return [Array<TimezoneTransition>] the transitions that define this
-  #   time zone in order of ascending timestamp.
-  def transitions; end
-
-  # Returns an `Array` of {TimezoneTransition} instances representing the
-  # times where the UTC offset of the time zone changes.
-  #
-  # Transitions are returned up to a given {Timestamp} (`to_timestamp`).
-  #
-  # A from {Timestamp} may also be supplied using the `from_timestamp`
-  # parameter. If `from_timestamp` is specified, only transitions from that
-  # time onwards will be returned.
-  #
-  # Comparisons with `to_timestamp` are exclusive. Comparisons with
-  # `from_timestamp` are inclusive. If a transition falls precisely on
-  # `to_timestamp`, it will be excluded. If a transition falls on
-  # `from_timestamp`, it will be included.
-  #
-  # Transitions returned are ordered by when they occur, from earliest to
-  # latest.
-  #
-  # @param to_timestamp [Timestamp] a {Timestamp} with a specified
-  #   {Timestamp#utc_offset utc_offset}. Transitions are returned if they
-  #   occur before this time.
-  # @param from_timestamp [Timestamp] an optional {Timestamp} with a
-  #   specified {Timestamp#utc_offset utc_offset}. If specified, transitions
-  #   are returned if they occur at or after this time.
-  # @raise [ArgumentError] may be raised if `to_timestamp` is `nil` or does
-  #   not have a specified {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `from_timestamp` is specified
-  #   but does not have a specified {Timestamp#utc_offset utc_offset}.
-  # @raise [ArgumentError] may be raised if `from_timestamp` is specified
-  #   but is not earlier than or at the same time as `to_timestamp`.
-  # @return [Array<TimezoneTransition>] an `Array` of {TimezoneTransition}
-  #   instances representing the times where the UTC offset of the time zone
-  #   changes.
-  def transitions_up_to(to_timestamp, from_timestamp = T.unsafe(nil)); end
-
-  private
-
-  # Performs a binary search on {transitions} to find the index of the
-  # earliest transition satisfying a condition.
-  #
-  # :nocov_array_bsearch_index:
-  #
-  # @return [Integer] the index of the earliest transition safisfying
-  #   the condition or `nil` if there are no such transitions.
-  # @yield [transition] the caller will be yielded to to test the search
-  #   condition.
-  # @yieldparam transition [TimezoneTransition] a {TimezoneTransition}
-  #   instance from {transitions}.
-  # @yieldreturn [Boolean] `true` for the earliest transition that
-  #   satisfies the condition and return `true` for all subsequent
-  #   transitions. In all other cases, the result of the block must be
-  #   `false`.
-  def find_minimum_transition(&block); end
-
-  # Determines if a transition occurs at or after a given {Timestamp},
-  # taking the {Timestamp#sub_second sub_second} into consideration.
-  #
-  # @param transition [TimezoneTransition] the transition to compare.
-  # @param timestamp [Timestamp] the timestamp to compare.
-  # @return [Boolean] `true` if `transition` occurs at or after `timestamp`,
-  #   otherwise `false`.
-  def transition_on_or_after_timestamp?(transition, timestamp); end
-end
-
-# A DataSource implementation that loads data from a 'zoneinfo' directory
-# containing compiled "TZif" version 3 (or earlier) files in addition to
-# iso3166.tab and zone1970.tab or zone.tab index files.
-#
-# To have TZInfo load the system zoneinfo files, call
-# {TZInfo::DataSource.set} as follows:
-#
-#     TZInfo::DataSource.set(:zoneinfo)
-#
-# To load zoneinfo files from a particular directory, pass the directory to
-# {TZInfo::DataSource.set}:
-#
-#     TZInfo::DataSource.set(:zoneinfo, directory)
-#
-# To load zoneinfo files from a particular directory, but load the
-# iso3166.tab index file from a separate location, pass the directory and
-# path to the iso3166.tab file to {TZInfo::DataSource.set}:
-#
-#     TZInfo::DataSource.set(:zoneinfo, directory, iso3166_path)
-#
-# Please note that versions of the 'zic' tool (used to build zoneinfo files)
-# that were released prior to February 2006 created zoneinfo files that used
-# 32-bit integers for transition timestamps. Later versions of zic produce
-# zoneinfo files that use 64-bit integers. If you have 32-bit zoneinfo files
-# on your system, then any queries falling outside of the range 1901-12-13
-# 20:45:52 to 2038-01-19 03:14:07 may be inaccurate.
-#
-# Most modern platforms include 64-bit zoneinfo files. However, Mac OS X (up
-# to at least 10.8.4) still uses 32-bit zoneinfo files.
-#
-# To check whether your zoneinfo files contain 32-bit or 64-bit transition
-# data, you can run the following code (substituting the identifier of the
-# zone you want to test for `zone_identifier`):
-#
-#     TZInfo::DataSource.set(:zoneinfo)
-#     dir = TZInfo::DataSource.get.zoneinfo_dir
-#     File.open(File.join(dir, zone_identifier), 'r') {|f| f.read(5) }
-#
-# If the last line returns `"TZif\\x00"`, then you have a 32-bit zoneinfo
-# file. If it returns `"TZif2"` or `"TZif3"` then you have a 64-bit zoneinfo
-# file.
-#
-# It is also worth noting that as of the 2017c release of the IANA Time Zone
-# Database, 64-bit zoneinfo files only include future transitions up to
-# 2038-01-19 03:14:07. Any queries falling after this time may be
-# inaccurate.
-class TZInfo::DataSources::ZoneinfoDataSource < ::TZInfo::DataSource
-  # Initializes a new {ZoneinfoDataSource}.
-  #
-  # If `zoneinfo_dir` is specified, it will be checked and used as the
-  # source of zoneinfo files.
-  #
-  # The directory must contain a file named iso3166.tab and a file named
-  # either zone1970.tab or zone.tab. These may either be included in the
-  # root of the directory or in a 'tab' sub-directory and named country.tab
-  # and zone_sun.tab respectively (as is the case on Solaris).
-  #
-  # Additionally, the path to iso3166.tab can be overridden using the
-  # `alternate_iso3166_tab_path` parameter.
-  #
-  # If `zoneinfo_dir` is not specified or `nil`, the paths referenced in
-  # {search_path} are searched in order to find a valid zoneinfo directory
-  # (one that contains zone1970.tab or zone.tab and iso3166.tab files as
-  # above).
-  #
-  # The paths referenced in {alternate_iso3166_tab_search_path} are also
-  # searched to find an iso3166.tab file if one of the searched zoneinfo
-  # directories doesn't contain an iso3166.tab file.
-  #
-  # @param zoneinfo_dir [String] an optional path to a directory to use as
-  #   the source of zoneinfo files.
-  # @param alternate_iso3166_tab_path [String] an optional path to the
-  #   iso3166.tab file.
-  # @raise [InvalidZoneinfoDirectory] if the iso3166.tab and zone1970.tab or
-  #   zone.tab files cannot be found using the `zoneinfo_dir` and
-  #   `alternate_iso3166_tab_path` parameters.
-  # @raise [ZoneinfoDirectoryNotFound] if no valid directory can be found
-  #   by searching.
-  # @return [ZoneinfoDataSource] a new instance of ZoneinfoDataSource
-  def initialize(zoneinfo_dir = T.unsafe(nil), alternate_iso3166_tab_path = T.unsafe(nil)); end
-
-  # Returns the value of attribute country_codes.
-  def country_codes; end
-
-  # Returns a frozen `Array` of all the available time zone identifiers. The
-  # identifiers are sorted according to `String#<=>`.
-  #
-  # @return [Array<String>] a frozen `Array` of all the available time zone
-  #   identifiers.
-  def data_timezone_identifiers; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # Returns an empty `Array`. There is no information about linked/aliased
-  # time zones in the zoneinfo files. When using {ZoneinfoDataSource}, every
-  # time zone will be returned as a {DataTimezone}.
-  #
-  # @return [Array<String>] an empty `Array`.
-  def linked_timezone_identifiers; end
-
-  # @return [String] a description of the {DataSource}.
-  def to_s; end
-
-  # @return [String] the zoneinfo directory being used.
-  def zoneinfo_dir; end
-
-  protected
-
-  # @param code [String] an ISO 3166-1 alpha-2 country code.
-  # @raise [InvalidCountryCode] if the country could not be found or the code
-  #   is invalid.
-  # @return [DataSources::CountryInfo] a {DataSources::CountryInfo} instance
-  #   for the given ISO 3166-1 alpha-2 country code.
-  def load_country_info(code); end
-
-  # Returns a {TimezoneInfo} instance for the given time zone identifier.
-  # The result will either be a {ConstantOffsetDataTimezoneInfo} or a
-  # {TransitionsDataTimezoneInfo}.
-  #
-  # @param identifier [String] A time zone identifier.
-  # @raise [InvalidTimezoneIdentifier] if the time zone is not found, the
-  #   identifier is invalid, the zoneinfo file cannot be opened or the
-  #   zoneinfo file is not valid.
-  # @return [TimezoneInfo] a {TimezoneInfo} instance for the given time zone
-  #   identifier.
-  def load_timezone_info(identifier); end
-
-  private
-
-  # Converts degrees, minutes and seconds to a Rational.
-  #
-  # @param sign [String] `'-'` or `'+'`.
-  # @param degrees [String] the number of degrees.
-  # @param minutes [String] the number of minutes.
-  # @param seconds [String] the number of seconds (optional).
-  # @return [Rational] the result of converting from degrees, minutes and
-  #   seconds to a `Rational`.
-  def dms_to_rational(sign, degrees, minutes, seconds = T.unsafe(nil)); end
-
-  # Recursively enumerate a directory of time zones.
-  #
-  # @param dir [Array<String>] the directory to enumerate as an `Array` of
-  #   path components.
-  # @param exclude [Array<String>] file names to exclude when scanning
-  #   `dir`.
-  # @yield [path] the path of each time zone file found is passed to
-  #   the block.
-  # @yieldparam path [Array<String>] the path of a time zone file as an
-  #   `Array` of path components.
-  def enum_timezones(dir, exclude = T.unsafe(nil), &block); end
-
-  # Finds a zoneinfo directory using {search_path} and
-  # {alternate_iso3166_tab_search_path}.
-  #
-  # @return [Array<String>] an `Array` containing the iso3166.tab and
-  #   zone.tab paths if a zoneinfo directory was found, otherwise `nil`.
-  def find_zoneinfo_dir; end
-
-  # Uses the iso3166.tab and zone1970.tab or zone.tab files to return a Hash
-  # mapping country codes to CountryInfo instances.
-  #
-  # @param iso3166_tab_path [String] the path to the iso3166.tab file.
-  # @param zone_tab_path [String] the path to the zone.tab file.
-  # @return [Hash<String, CountryInfo>] a mapping from ISO 3166-1 alpha-2
-  #   country codes to {CountryInfo} instances.
-  def load_countries(iso3166_tab_path, zone_tab_path); end
-
-  # Scans @zoneinfo_dir and returns an `Array` of available time zone
-  # identifiers. The result is sorted according to `String#<=>`.
-  #
-  # @return [Array<String>] an `Array` containing all the time zone
-  #   identifiers found.
-  def load_timezone_identifiers; end
-
-  # Attempts to resolve the path to a tab file given its standard names and
-  # tab sub-directory name (as used on Solaris).
-  #
-  # @param zoneinfo_path [String] the path to a zoneinfo directory.
-  # @param standard_names [Array<String>] the standard names for the tab
-  #   file.
-  # @param tab_name [String] the alternate name for the tab file to check in
-  #   the tab sub-directory.
-  # @return [String] the path to the tab file.
-  def resolve_tab_path(zoneinfo_path, standard_names, tab_name); end
-
-  # Validates a zoneinfo directory and returns the paths to the iso3166.tab
-  # and zone1970.tab or zone.tab files if valid. If the directory is not
-  # valid, returns `nil`.
-  #
-  # The path to the iso3166.tab file may be overridden by passing in a path.
-  # This is treated as either absolute or relative to the current working
-  # directory.
-  #
-  # @param path [String] the path to a possible zoneinfo directory.
-  # @param iso3166_tab_path [String] an optional path to an external
-  #   iso3166.tab file.
-  # @return [Array<String>] an `Array` containing the iso3166.tab and
-  #   zone.tab paths if the directory is valid, otherwise `nil`.
-  def validate_zoneinfo_dir(path, iso3166_tab_path = T.unsafe(nil)); end
-
-  class << self
-    # An `Array` of paths that will be checked to find an alternate
-    # iso3166.tab file if one was not included in the zoneinfo directory
-    # (for example, on FreeBSD and OpenBSD systems).
-    #
-    # Paths are checked in the order they appear in the `Array`.
-    #
-    # The default value is `['/usr/share/misc/iso3166.tab',
-    # '/usr/share/misc/iso3166']`.
-    #
-    # @return [Array<String>] an `Array` of paths to check in order to
-    #   locate an iso3166.tab file.
-    def alternate_iso3166_tab_search_path; end
-
-    # Sets the paths to check to locate an alternate iso3166.tab file if one
-    # was not included in the zoneinfo directory.
-    #
-    # Can be set to an `Array` of paths or a `String` containing paths
-    # separated with `File::PATH_SEPARATOR`.
-    #
-    # Paths are checked in the order they appear in the array.
-    #
-    # Set to `nil` to revert to the default paths.
-    #
-    # @param alternate_iso3166_tab_search_path [Object] either `nil` or a
-    #   list of paths to check as either an `Array` of `String` or a
-    #   `File::PATH_SEPARATOR` separated `String`.
-    def alternate_iso3166_tab_search_path=(alternate_iso3166_tab_search_path); end
-
-    # An `Array` of directories that will be checked to find the system
-    # zoneinfo directory.
-    #
-    # Directories are checked in the order they appear in the `Array`.
-    #
-    # The default value is `['/usr/share/zoneinfo',
-    # '/usr/share/lib/zoneinfo', '/etc/zoneinfo']`.
-    #
-    # @return [Array<String>] an `Array` of directories to check in order to
-    #   find the system zoneinfo directory.
-    def search_path; end
-
-    # Sets the directories to be checked when locating the system zoneinfo
-    # directory.
-    #
-    # Can be set to an `Array` of directories or a `String` containing
-    # directories separated with `File::PATH_SEPARATOR`.
-    #
-    # Directories are checked in the order they appear in the `Array` or
-    # `String`.
-    #
-    # Set to `nil` to revert to the default paths.
-    #
-    # @param search_path [Object] either `nil` or a list of directories to
-    #   check as either an `Array` of `String` or a `File::PATH_SEPARATOR`
-    #   separated `String`.
-    def search_path=(search_path); end
-
-    private
-
-    # Processes a path for use as the {search_path} or
-    # {alternate_iso3166_tab_search_path}.
-    #
-    # @param path [Object] either `nil` or a list of paths to check as
-    #   either an `Array` of `String` or a `File::PATH_SEPARATOR` separated
-    #   `String`.
-    # @param default [Array<String>] the default value.
-    # @return [Array<String>] the processed path.
-    def process_search_path(path, default); end
-  end
-end
-
-# The default value of {ZoneinfoDataSource.alternate_iso3166_tab_search_path}.
-TZInfo::DataSources::ZoneinfoDataSource::DEFAULT_ALTERNATE_ISO3166_TAB_SEARCH_PATH = T.let(T.unsafe(nil), Array)
-
-# The default value of {ZoneinfoDataSource.search_path}.
-TZInfo::DataSources::ZoneinfoDataSource::DEFAULT_SEARCH_PATH = T.let(T.unsafe(nil), Array)
-
-# Files and directories in the top level zoneinfo directory that will be
-# excluded from the list of available time zones:
-#
-#   - +VERSION is included on Mac OS X.
-#   - leapseconds is a list of leap seconds.
-#   - localtime is the current local timezone (may be a link).
-#   - posix, posixrules and right are directories containing other
-#     versions of the zoneinfo files.
-#   - SECURITY is included in the Arch Linux tzdata package.
-#   - src is a directory containing the tzdata source included on Solaris.
-#   - timeconfig is a symlink included on Slackware.
-TZInfo::DataSources::ZoneinfoDataSource::EXCLUDED_FILENAMES = T.let(T.unsafe(nil), Array)
-
-# A {ZoneinfoDirectoryNotFound} exception is raised if no valid zoneinfo
-# directory could be found when checking the paths listed in
-# {ZoneinfoDataSource.search_path}. A valid zoneinfo directory is one that
-# contains time zone files, a country code index file named iso3166.tab and
-# a time zone index file named zone1970.tab or zone.tab.
-class TZInfo::DataSources::ZoneinfoDirectoryNotFound < ::StandardError; end
-
-# Reads compiled zoneinfo TZif (\0, 2 or 3) files.
-class TZInfo::DataSources::ZoneinfoReader
-  # Initializes a new {ZoneinfoReader}.
-  #
-  # @param posix_tz_parser [PosixTimeZoneParser] a {PosixTimeZoneParser}
-  #   instance to use to parse POSIX-style TZ strings.
-  # @param string_deduper [StringDeduper] a {StringDeduper} instance to use
-  #   to dedupe abbreviations.
-  # @return [ZoneinfoReader] a new instance of ZoneinfoReader
-  def initialize(posix_tz_parser, string_deduper); end
-
-  # Reads a zoneinfo structure from the given path. Returns either a
-  # {TimezoneOffset} that is constantly observed or an `Array`
-  # {TimezoneTransition}s.
-  #
-  # @param file_path [String] the path of a zoneinfo file.
-  # @raise [SecurityError] if safe mode is enabled and `file_path` is
-  #   tainted.
-  # @raise [InvalidZoneinfoFile] if `file_path`` does not refer to a valid
-  #   zoneinfo file.
-  # @return [Object] either a {TimezoneOffset} or an `Array` of
-  #   {TimezoneTransition}s.
-  def read(file_path); end
-
-  private
-
-  # Apply the rules from the TZ string when there were defined
-  # transitions. Checks for a matching offset with the last transition.
-  # Redefines the last transition if required and if the rules don't
-  # specific a constant offset, generates transitions until 100 years into
-  # the future (at the time of loading zoneinfo_reader.rb).
-  #
-  # @param file [IO] the file being processed.
-  # @param transitions [Array<TimezoneTransition>] the defined transitions.
-  # @param offsets [Array<TimezoneOffset>] the offsets used by the defined
-  #   transitions.
-  # @param rules [Object] a {TimezoneOffset} specifying a constant offset or
-  #   {AnnualRules} instance specfying transitions.
-  # @raise [InvalidZoneinfoFile] if the first offset does not match the
-  #   rules.
-  # @raise [InvalidZoneinfoFile] if the previous offset of the first
-  #   generated transition does not match the offset of the last defined
-  #   transition.
-  def apply_rules_with_transitions(file, transitions, offsets, rules); end
-
-  # Apply the rules from the TZ string when there were no defined
-  # transitions. Checks for a matching offset. Returns the rules-based
-  # constant offset or generates transitions from 1970 until 100 years into
-  # the future (at the time of loading zoneinfo_reader.rb).
-  #
-  # @param file [IO] the file being processed.
-  # @param first_offset [TimezoneOffset] the first offset included in the
-  #   file that would normally apply without the rules.
-  # @param rules [Object] a {TimezoneOffset} specifying a constant offset or
-  #   {AnnualRules} instance specfying transitions.
-  # @raise [InvalidZoneinfoFile] if the first offset does not match the
-  #   rules.
-  # @return [Object] either a {TimezoneOffset} or an `Array` of
-  #   {TimezoneTransition}s.
-  def apply_rules_without_transitions(file, first_offset, rules); end
-
-  # Reads the given number of bytes from the given file and checks that the
-  # correct number of bytes could be read.
-  #
-  # @param file [IO] the file to read from.
-  # @param bytes [Integer] the number of bytes to read.
-  # @raise [InvalidZoneinfoFile] if the number of bytes available didn't
-  #   match the number requested.
-  # @return [String] the bytes that were read.
-  def check_read(file, bytes); end
-
-  # Zoneinfo files don't include the offset from standard time (std_offset)
-  # for DST periods. Derive the base offset (base_utc_offset) where DST is
-  # observed from either the previous or next non-DST period.
-  #
-  # @param transitions [Array<Hash>] an `Array` of transition hashes.
-  # @param offsets [Array<Hash>] an `Array` of offset hashes.
-  # @return [Integer] the index of the offset to be used prior to the first
-  #   transition.
-  def derive_offsets(transitions, offsets); end
-
-  # Finds an offset that is equivalent to the one specified in the given
-  # `Array`. Matching is performed with {TimezoneOffset#==}.
-  #
-  # @param offsets [Array<TimezoneOffset>] an `Array` to search.
-  # @param offset [TimezoneOffset] the offset to search for.
-  # @return [TimezoneOffset] the matching offset from `offsets` or `nil`
-  #   if not found.
-  def find_existing_offset(offsets, offset); end
-
-  # Translates an unsigned 32-bit integer (as returned by unpack) to signed
-  # 32-bit.
-  #
-  # @param long [Integer] an unsigned 32-bit integer.
-  # @return [Integer] {long} translated to signed 32-bit.
-  def make_signed_int32(long); end
-
-  # Translates a pair of unsigned 32-bit integers (as returned by unpack,
-  # most significant first) to a signed 64-bit integer.
-  #
-  # @param high [Integer] the most significant 32-bits.
-  # @param low [Integer] the least significant 32-bits.
-  # @return [Integer] {high} and {low} combined and translated to signed
-  #   64-bit.
-  def make_signed_int64(high, low); end
-
-  # Determines if the offset from a transition matches the offset from a
-  # rule. This is a looser match than equality, not requiring that the
-  # base_utc_offset and std_offset both match (which have to be derived for
-  # transitions, but are known for rules.
-  #
-  # @param offset [TimezoneOffset] an offset from a transition.
-  # @param rule_offset [TimezoneOffset] an offset from a rule.
-  # @return [Boolean] whether the offsets match.
-  def offset_matches_rule?(offset, rule_offset); end
-
-  # Parses a zoneinfo file and returns either a {TimezoneOffset} that is
-  # constantly observed or an `Array` of {TimezoneTransition}s.
-  #
-  # @param file [IO] the file to be read.
-  # @raise [InvalidZoneinfoFile] if the file is not a valid zoneinfo file.
-  # @return [Object] either a {TimezoneOffset} or an `Array` of
-  #   {TimezoneTransition}s.
-  def parse(file); end
-
-  # Returns a new AnnualRules instance with standard and daylight savings
-  # offsets replaced with equivalents from an array. This reduces the memory
-  # requirement for loaded time zones by reusing offsets for rule-generated
-  # transitions.
-  #
-  # @param offsets [Array<TimezoneOffset>] an `Array` to search for
-  #   equivalent offsets.
-  # @param annual_rules [AnnualRules] the {AnnualRules} instance to check.
-  # @return [AnnualRules] either a new {AnnualRules} instance with either
-  #   the {AnnualRules#std_offset std_offset} or {AnnualRules#dst_offset
-  #   dst_offset} replaced, or the original instance if no equivalent for
-  #   either {AnnualRules#std_offset std_offset} or {AnnualRules#dst_offset
-  #   dst_offset} could be found.
-  def replace_with_existing_offsets(offsets, annual_rules); end
-
-  # Validates the offset indicated to be observed by the rules before the
-  # first generated transition against the offset of the last defined
-  # transition.
-  #
-  # Fix the last defined transition if it differ on just base/std offsets
-  # (which are derived). Raise an error if the observed UTC offset or
-  # abbreviations differ.
-  #
-  # @param file [IO] the file being processed.
-  # @param last_defined [TimezoneTransition] the last defined transition in
-  #   the file.
-  # @param first_rule_offset [TimezoneOffset] the offset the rules indicate
-  #   is observed prior to the first rules generated transition.
-  # @raise [InvalidZoneinfoFile] if the offset of {last_defined} and
-  #   {first_rule_offset} do not match.
-  # @return [TimezoneTransition] the last defined transition (either the
-  #   original instance or a replacement).
-  def validate_and_fix_last_defined_transition_offset(file, last_defined, first_rule_offset); end
-end
-
-# The year to generate transitions up to.
-#
-# @private
-TZInfo::DataSources::ZoneinfoReader::GENERATE_UP_TO = T.let(T.unsafe(nil), Integer)
-
-# Represents time zones that are defined by rules that set out when
-# transitions occur.
-class TZInfo::DataTimezone < ::TZInfo::InfoTimezone
-  # Returns the canonical {Timezone} instance for this {DataTimezone}.
-  #
-  # For a {DataTimezone}, this is always `self`.
-  #
-  # @return [Timezone] `self`.
-  def canonical_zone; end
-
-  # Returns the {TimezonePeriod} that is valid at a given time.
-  #
-  # Unlike {period_for_local} and {period_for_utc}, the UTC offset of the
-  # `time` parameter is taken into consideration.
-  #
-  # @param time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified
-  #   offset.
-  # @return [TimezonePeriod] the {TimezonePeriod} that is valid at `time`.
-  def period_for(time); end
-
-  # Returns the set of {TimezonePeriod}s that are valid for the given
-  # local time as an `Array`.
-  #
-  # The UTC offset of the `local_time` parameter is ignored (it is treated as
-  # a time in the time zone represented by `self`).
-  #
-  # This will typically return an `Array` containing a single
-  # {TimezonePeriod}. More than one {TimezonePeriod} will be returned when the
-  # local time is ambiguous (for example, when daylight savings time ends). An
-  # empty `Array` will be returned when the local time is not valid (for
-  # example, when daylight savings time begins).
-  #
-  # To obtain just a single {TimezonePeriod} in all cases, use
-  # {period_for_local} instead and specify how ambiguities should be resolved.
-  #
-  # @param local_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `local_time` is `nil`.
-  # @return [Array<TimezonePeriod>] the set of {TimezonePeriod}s that are
-  #   valid at `local_time`.
-  def periods_for_local(local_time); end
-
-  # Returns an `Array` of {TimezoneTransition} instances representing the
-  # times where the UTC offset of the timezone changes.
-  #
-  # Transitions are returned up to a given time (`to`).
-  #
-  # A from time may also be supplied using the `from` parameter. If from is
-  # not `nil`, only transitions from that time onwards will be returned.
-  #
-  # Comparisons with `to` are exclusive. Comparisons with `from` are
-  # inclusive. If a transition falls precisely on `to`, it will be excluded.
-  # If a transition falls on `from`, it will be included.
-  #
-  # @param to [Object] a `Time`, `DateTime` or {Timestamp} specifying the
-  #   latest (exclusive) transition to return.
-  # @param from [Object] an optional `Time`, `DateTime` or {Timestamp}
-  #   specifying the earliest (inclusive) transition to return.
-  # @raise [ArgumentError] if `from` is specified and `to` is not greater than
-  #   `from`.
-  # @raise [ArgumentError] is raised if `to` is `nil`.
-  # @raise [ArgumentError] if either `to` or `from` is a {Timestamp} with an
-  #   unspecified offset.
-  # @return [Array<TimezoneTransition>] the transitions that are earlier than
-  #   `to` and, if specified, at or later than `from`. Transitions are ordered
-  #   by when they occur, from earliest to latest.
-  def transitions_up_to(to, from = T.unsafe(nil)); end
-end
-
-# A subclass of `DateTime` used to represent local times. {DateTimeWithOffset}
-# holds a reference to the related {TimezoneOffset} and overrides various
-# methods to return results appropriate for the {TimezoneOffset}. Certain
-# operations will clear the associated {TimezoneOffset} (if the
-# {TimezoneOffset} would not necessarily be valid for the result). Once the
-# {TimezoneOffset} has been cleared, {DateTimeWithOffset} behaves identically
-# to `DateTime`.
-#
-# Arithmetic performed on {DateTimeWithOffset} instances is _not_ time
-# zone-aware. Regardless of whether transitions in the time zone are crossed,
-# results of arithmetic operations will always maintain the same offset from
-# UTC (`offset`). The associated {TimezoneOffset} will aways be cleared.
-class TZInfo::DateTimeWithOffset < ::DateTime
-  include ::TZInfo::WithOffset
-
-  # An overridden version of `DateTime#downto` that clears the associated
-  # {TimezoneOffset} of the returned or yielded instances.
-  def downto(min); end
-
-  # An overridden version of `DateTime#england` that preserves the associated
-  # {TimezoneOffset}.
-  #
-  # @return [DateTime]
-  def england; end
-
-  # An overridden version of `DateTime#gregorian` that preserves the
-  # associated {TimezoneOffset}.
-  #
-  # @return [DateTime]
-  def gregorian; end
-
-  # An overridden version of `DateTime#italy` that preserves the associated
-  # {TimezoneOffset}.
-  #
-  # @return [DateTime]
-  def italy; end
-
-  # An overridden version of `DateTime#julian` that preserves the associated
-  # {TimezoneOffset}.
-  #
-  # @return [DateTime]
-  def julian; end
-
-  # An overridden version of `DateTime#new_start` that preserves the
-  # associated {TimezoneOffset}.
-  #
-  # @return [DateTime]
-  def new_start(start = T.unsafe(nil)); end
-
-  # Sets the associated {TimezoneOffset}.
-  #
-  # @param timezone_offset [TimezoneOffset] a {TimezoneOffset} valid at the
-  #   time and for the offset of this {DateTimeWithOffset}.
-  # @raise [ArgumentError] if `timezone_offset` is `nil`.
-  # @raise [ArgumentError] if `timezone_offset.observed_utc_offset` does not
-  #   equal `self.offset * 86400`.
-  # @return [DateTimeWithOffset] `self`.
-  def set_timezone_offset(timezone_offset); end
-
-  # An overridden version of `DateTime#step` that clears the associated
-  # {TimezoneOffset} of the returned or yielded instances.
-  def step(limit, step = T.unsafe(nil)); end
-
-  # @return [TimezoneOffset] the {TimezoneOffset} associated with this
-  #   instance.
-  def timezone_offset; end
-
-  # An overridden version of `DateTime#to_time` that, if there is an
-  # associated {TimezoneOffset}, returns a {DateTimeWithOffset} with that
-  # offset.
-  #
-  # @return [Time] if there is an associated {TimezoneOffset}, a
-  #   {TimeWithOffset} representation of this {DateTimeWithOffset}, otherwise
-  #   a `Time` representation.
-  def to_time; end
-
-  # An overridden version of `DateTime#upto` that clears the associated
-  # {TimezoneOffset} of the returned or yielded instances.
-  def upto(max); end
-
-  protected
-
-  # Clears the associated {TimezoneOffset}.
-  #
-  # @return [DateTimeWithOffset] `self`.
-  def clear_timezone_offset; end
-end
-
-# A rule that transitions on the nth occurrence of a particular day of week
-# of a calendar month.
-#
-# @private
-class TZInfo::DayOfMonthTransitionRule < ::TZInfo::DayOfWeekTransitionRule
-  # Initializes a new {DayOfMonthTransitionRule}.
-  #
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @param week [Integer] the week of the month when the transition occurs (1
-  #   to 4).
-  # @param day_of_week [Integer] the day of the week when the transition
-  #   occurs. 0 is Sunday, 6 is Saturday.
-  # @param month [Integer] the month of the year when the transition occurs.
-  # @raise [ArgumentError] if `week` is less than 1 or greater than 4.
-  # @raise [ArgumentError] if `day_of_week` is not an `Integer`.
-  # @raise [ArgumentError] if `day_of_week` is less than 0 or greater than 6.
-  # @raise [ArgumentError] if `month` is less than 1 or greater than 12.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @raise [ArgumentError] if `month` is not an `Integer`.
-  # @raise [ArgumentError] if `week` is not an `Integer`.
-  # @return [DayOfMonthTransitionRule] a new instance of DayOfMonthTransitionRule
-  def initialize(month, week, day_of_week, transition_at = T.unsafe(nil)); end
-
-  # Determines if this {DayOfMonthTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {DayOfMonthTransitionRule} with the
-  #   same {transition_at}, month, week and day of week as this
-  #   {DayOfMonthTransitionRule}, otherwise `false`.
-  def ==(r); end
-
-  # Determines if this {DayOfMonthTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {DayOfMonthTransitionRule} with the
-  #   same {transition_at}, month, week and day of week as this
-  #   {DayOfMonthTransitionRule}, otherwise `false`.
-  def eql?(r); end
-
-  protected
-
-  # Returns a `Time` representing midnight local time on the day specified by
-  # the rule for the given offset and year.
-  #
-  # @param offset [TimezoneOffset] the current offset at the time of the
-  #   transition.
-  # @param year [Integer] the year in which the transition occurs.
-  # @return [Time] midnight local time on the day specified by the rule for
-  #   the given offset and year.
-  def get_day(offset, year); end
-
-  # @return [Array] an `Array` of parameters that will influence the output of
-  #   {hash}.
-  def hash_args; end
-
-  # @return [Integer] the day the week starts on for a month starting on a
-  #   Sunday.
-  def offset_start; end
-end
-
-# A base class for rules that transition on a particular day of week of a
-# given week (subclasses specify which week of the month).
-#
-# @abstract
-# @private
-class TZInfo::DayOfWeekTransitionRule < ::TZInfo::TransitionRule
-  # Initializes a new {DayOfWeekTransitionRule}.
-  #
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @param day_of_week [Integer] the day of the week when the transition
-  #   occurs. 0 is Sunday, 6 is Saturday.
-  # @param month [Integer] the month of the year when the transition occurs.
-  # @raise [ArgumentError] if `day_of_week` is not an `Integer`.
-  # @raise [ArgumentError] if `day_of_week` is less than 0 or greater than 6.
-  # @raise [ArgumentError] if `month` is not an `Integer`.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @raise [ArgumentError] if `month` is less than 1 or greater than 12.
-  # @return [DayOfWeekTransitionRule] a new instance of DayOfWeekTransitionRule
-  def initialize(month, day_of_week, transition_at); end
-
-  # Determines if this {DayOfWeekTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {DayOfWeekTransitionRule} with the
-  #   same {transition_at}, month and day of week as this
-  #   {DayOfWeekTransitionRule}, otherwise `false`.
-  def ==(r); end
-
-  # Determines if this {DayOfWeekTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {DayOfWeekTransitionRule} with the
-  #   same {transition_at}, month and day of week as this
-  #   {DayOfWeekTransitionRule}, otherwise `false`.
-  def eql?(r); end
-
-  # @return [Boolean] `false`.
-  def is_always_first_day_of_year?; end
-
-  # @return [Boolean] `false`.
-  def is_always_last_day_of_year?; end
-
-  protected
-
-  # @return [Integer] the day of the week (0 to 6 for Sunday to Monday).
-  def day_of_week; end
-
-  # @return [Array] an `Array` of parameters that will influence the output of
-  #   {hash}.
-  def hash_args; end
-
-  # @return [Integer] the month of the year (1 to 12).
-  def month; end
-end
-
-# A base class for transition rules that activate based on an integer day of
-# the year.
-#
-# @abstract
-# @private
-class TZInfo::DayOfYearTransitionRule < ::TZInfo::TransitionRule
-  # Initializes a new {DayOfYearTransitionRule}.
-  #
-  # @param day [Integer] the day of the year on which the transition occurs.
-  #   The precise meaning is defined by subclasses.
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @raise [ArgumentError] if `day` is not an `Integer`.
-  # @return [DayOfYearTransitionRule] a new instance of DayOfYearTransitionRule
-  def initialize(day, transition_at); end
-
-  # Determines if this {DayOfYearTransitionRule} is equal to another instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {DayOfYearTransitionRule} with the
-  #   same {transition_at} and day as this {DayOfYearTransitionRule},
-  #   otherwise `false`.
-  def ==(r); end
-
-  # Determines if this {DayOfYearTransitionRule} is equal to another instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {DayOfYearTransitionRule} with the
-  #   same {transition_at} and day as this {DayOfYearTransitionRule},
-  #   otherwise `false`.
-  def eql?(r); end
-
-  protected
-
-  # @return [Array] an `Array` of parameters that will influence the output of
-  #   {hash}.
-  def hash_args; end
-
-  # @return [Integer] the day multipled by the number of seconds in a day.
-  def seconds; end
-end
-
-# Modules and classes used by the format 1 version of TZInfo::Data.
-#
-# @private
-module TZInfo::Format1; end
-
-# Instances of {Format1::CountryDefiner} are yielded to the format 1 version
-# of `TZInfo::Data::Indexes::Countries` by {CountryIndexDefinition} to allow
-# the zones of a country to be specified.
-#
-# @private
-class TZInfo::Format1::CountryDefiner < ::TZInfo::Format2::CountryDefiner
-  # Initializes a new {CountryDefiner}.
-  #
-  # @return [CountryDefiner] a new instance of CountryDefiner
-  def initialize(identifier_deduper, description_deduper); end
-end
-
-# The format 1 TZInfo::Data country index file includes
-# {Format1::CountryIndexDefinition}, which provides a
-# {CountryIndexDefinition::ClassMethods#country country} method used to
-# define each country in the index.
-#
-# @private
-module TZInfo::Format1::CountryIndexDefinition
-  mixes_in_class_methods ::TZInfo::Format1::CountryIndexDefinition::ClassMethods
-
-  class << self
-    # Adds class methods to the includee and initializes class instance
-    # variables.
-    #
-    # @param base [Module] the includee.
-    def append_features(base); end
-  end
-end
-
-# Class methods for inclusion.
-#
-# @private
-module TZInfo::Format1::CountryIndexDefinition::ClassMethods
-  # @return [Hash<String, DataSources::CountryInfo>] a frozen `Hash`
-  #   of all the countries that have been defined in the index keyed by
-  #   their codes.
-  def countries; end
-
-  private
-
-  # Defines a country with an ISO 3166-1 alpha-2 country code and name.
-  #
-  # @param code [String] the ISO 3166-1 alpha-2 country code.
-  # @param name [String] the name of the country.
-  # @yield [definer] (optional) to obtain the time zones for the country.
-  # @yieldparam definer [CountryDefiner] a {CountryDefiner} instance.
-  def country(code, name); end
-end
-
-# Instances of {Format1::TimezoneDefiner} are yielded to TZInfo::Data
-# format 1 modules by {TimezoneDefinition} to allow the offsets and
-# transitions of the time zone to be specified.
-#
-# @private
-class TZInfo::Format1::TimezoneDefiner < ::TZInfo::Format2::TimezoneDefiner
-  # Defines an offset.
-  #
-  # @param id [Symbol] an arbitrary value used identify the offset in
-  #   subsequent calls to transition. It must be unique.
-  # @param utc_offset [Integer] the base offset from UTC of the zone in
-  #   seconds. This does not include daylight savings time.
-  # @param std_offset [Integer] the daylight savings offset from the base
-  #   offset in seconds. Typically either 0 or 3600.
-  # @param abbreviation [Symbol] an abbreviation for the offset, for
-  #   example, `:EST` or `:EDT`.
-  # @raise [ArgumentError] if another offset has already been defined with
-  #   the given id.
-  def offset(id, utc_offset, std_offset, abbreviation); end
-
-  # Defines a transition to a given offset.
-  #
-  # Transitions must be defined in increasing time order.
-  #
-  # @param year [Integer] the UTC year in which the transition occurs. Used
-  #   in earlier versions of TZInfo, but now ignored.
-  # @param month [Integer] the UTC month in which the transition occurs.
-  #   Used in earlier versions of TZInfo, but now ignored.
-  # @param offset_id [Symbol] references the id of a previously defined
-  #   offset (see #offset).
-  # @param timestamp_value [Integer] the time the transition occurs as an
-  #   Integer number of seconds since 1970-01-01 00:00:00 UTC ignoring leap
-  #   seconds (i.e. each day is treated as if it were 86,400 seconds long).
-  # @param datetime_numerator [Integer] the time of the transition as the
-  #   numerator of the `Rational` returned by `DateTime#ajd`. Used in
-  #   earlier versions of TZInfo, but now ignored.
-  # @param datetime_denominator [Integer] the time of the transition as the
-  #   denominator of the `Rational` returned by `DateTime#ajd`. Used in
-  #   earlier versions of TZInfo, but now ignored.
-  # @raise [ArgumentError] if `offset_id` does not reference a defined
-  #   offset.
-  # @raise [ArgumentError] if `timestamp_value` is not greater than the
-  #   `timestamp_value` of the previously defined transition.
-  # @raise [ArgumentError] if `datetime_numerator` is specified, but
-  #   `datetime_denominator` is not. In older versions of TZInfo, it was
-  #   possible to define a transition with the `DateTime` numerator as the
-  #   4th parameter and the denominator as the 5th parameter. This style of
-  #   definition is not used in released versions of TZInfo::Data.
-  def transition(year, month, offset_id, timestamp_value, datetime_numerator = T.unsafe(nil), datetime_denominator = T.unsafe(nil)); end
-end
-
-# {Format1::TimezoneDefinition} is included into format 1 time zone
-# definition modules and provides the methods for defining time zones.
-#
-# @private
-module TZInfo::Format1::TimezoneDefinition
-  mixes_in_class_methods ::TZInfo::Format2::TimezoneDefinition::ClassMethods
-  mixes_in_class_methods ::TZInfo::Format1::TimezoneDefinition::ClassMethods
-
-  class << self
-    # Adds class methods to the includee.
-    #
-    # @param base [Module] the includee.
-    def append_features(base); end
-  end
-end
-
-# Class methods for inclusion.
-#
-# @private
-module TZInfo::Format1::TimezoneDefinition::ClassMethods
-  private
-
-  # {Format2::TimezoneDefinition::ClassMethods#timezone}.
-  #
-  # @return the class to be instantiated and yielded by
-  def timezone_definer_class; end
-end
-
-# The format 1 TZInfo::Data time zone index file includes
-# {Format1::TimezoneIndexDefinition}, which provides methods used to define
-# time zones in the index.
-#
-# @private
-module TZInfo::Format1::TimezoneIndexDefinition
-  mixes_in_class_methods ::TZInfo::Format1::TimezoneIndexDefinition::ClassMethods
-
-  class << self
-    # Adds class methods to the includee and initializes class instance
-    # variables.
-    #
-    # @param base [Module] the includee.
-    def append_features(base); end
-  end
-end
-
-# Class methods for inclusion.
-#
-# @private
-module TZInfo::Format1::TimezoneIndexDefinition::ClassMethods
-  # @return [Array<String>] a frozen `Array` containing the identifiers of
-  #   all data time zones. Identifiers are sorted according to
-  #   `String#<=>`.
-  def data_timezones; end
-
-  # @return [Array<String>] a frozen `Array` containing the identifiers of
-  #   all linked time zones. Identifiers are sorted according to
-  #   `String#<=>`.
-  def linked_timezones; end
-
-  private
-
-  # Adds a linked time zone to the index.
-  #
-  # @param identifier [String] the time zone identifier.
-  def linked_timezone(identifier); end
-
-  # Adds a data time zone to the index.
-  #
-  # @param identifier [String] the time zone identifier.
-  def timezone(identifier); end
-end
-
-# Modules and classes used by the format 2 version of TZInfo::Data.
-#
-# @private
-module TZInfo::Format2; end
-
-# Instances of {Format2::CountryDefiner} are yielded to the format 2 version
-# of `TZInfo::Data::Indexes::Countries` by {CountryIndexDefiner} to allow
-# the zones of a country to be specified.
-#
-# @private
-class TZInfo::Format2::CountryDefiner
-  # Initializes a new {CountryDefiner}.
-  #
-  # @param shared_timezones [Hash<Symbol, CountryTimezone>] a `Hash`
-  #   containing time zones shared by more than one country, keyed by a
-  #   unique reference.
-  # @param identifier_deduper [StringDeduper] a {StringDeduper} instance to
-  #   use when deduping time zone identifiers.
-  # @param description_deduper [StringDeduper] a {StringDeduper} instance to
-  #   use when deduping time zone descriptions.
-  # @return [CountryDefiner] a new instance of CountryDefiner
-  def initialize(shared_timezones, identifier_deduper, description_deduper); end
-
-  # @overload timezone
-  # @overload timezone
-  def timezone(identifier_or_reference, latitude_numerator = T.unsafe(nil), latitude_denominator = T.unsafe(nil), longitude_numerator = T.unsafe(nil), longitude_denominator = T.unsafe(nil), description = T.unsafe(nil)); end
-
-  # @return [Array<CountryTimezone>] the time zones observed in the country.
-  def timezones; end
-end
-
-# Instances of {Format2::CountryIndexDefiner} are yielded to the format 2
-# version of `TZInfo::Data::Indexes::Countries` by {CountryIndexDefinition}
-# to allow countries and their time zones to be specified.
-#
-# @private
-class TZInfo::Format2::CountryIndexDefiner
-  # Initializes a new {CountryIndexDefiner}.
-  #
-  # @param identifier_deduper [StringDeduper] a {StringDeduper} instance to
-  #   use when deduping time zone identifiers.
-  # @param description_deduper [StringDeduper] a {StringDeduper} instance to
-  #   use when deduping time zone descriptions.
-  # @return [CountryIndexDefiner] a new instance of CountryIndexDefiner
-  def initialize(identifier_deduper, description_deduper); end
-
-  # @return [Hash<String, CountryInfo>] a `Hash` of all the countries that
-  #   have been defined in the index keyed by their codes.
-  def countries; end
-
-  # Defines a country.
-  #
-  # @param code [String] The ISO 3166-1 alpha-2 code of the country.
-  # @param name [String] Then name of the country.
-  # @yield [definer] yields (optional) to obtain the time zones for the
-  #   country.
-  # @yieldparam definer [CountryDefiner] a {CountryDefiner}
-  #   instance that should be used to specify the time zones of the country.
-  def country(code, name); end
-
-  # Defines a time zone shared by many countries with an reference for
-  # subsequent use in country definitions. The latitude and longitude are
-  # given as the numerator and denominator of a `Rational`.
-  #
-  # @param reference [Symbol] a unique reference for the time zone.
-  # @param identifier [String] the time zone identifier.
-  # @param latitude_numerator [Integer] the numerator of the latitude.
-  # @param latitude_denominator [Integer] the denominator of the latitude.
-  # @param longitude_numerator [Integer] the numerator of the longitude.
-  # @param longitude_denominator [Integer] the denominator of the longitude.
-  # @param description [String] an optional description for the time zone.
-  def timezone(reference, identifier, latitude_numerator, latitude_denominator, longitude_numerator, longitude_denominator, description = T.unsafe(nil)); end
-end
-
-# The format 2 country index file includes
-# {Format2::CountryIndexDefinition}, which provides a
-# {CountryIndexDefinition::ClassMethods#country_index country_index} method
-# used to define the country index.
-#
-# @private
-module TZInfo::Format2::CountryIndexDefinition
-  mixes_in_class_methods ::TZInfo::Format2::CountryIndexDefinition::ClassMethods
-
-  class << self
-    # Adds class methods to the includee and initializes class instance
-    # variables.
-    #
-    # @param base [Module] the includee.
-    def append_features(base); end
-  end
-end
-
-# Class methods for inclusion.
-#
-# @private
-module TZInfo::Format2::CountryIndexDefinition::ClassMethods
-  # @return [Hash<String, DataSources::CountryInfo>] a frozen `Hash`
-  #   of all the countries that have been defined in the index keyed by
-  #   their codes.
-  def countries; end
-
-  private
-
-  # Defines the index.
-  #
-  # @yield [definer] yields to allow the index to be defined.
-  # @yieldparam definer [CountryIndexDefiner] a {CountryIndexDefiner}
-  #   instance that should be used to define the index.
-  def country_index; end
-end
-
-# Instances of {TimezoneDefiner} are yielded to TZInfo::Data modules by
-# {TimezoneDefinition} to allow the offsets and transitions of the time zone
-# to be specified.
-#
-# @private
-class TZInfo::Format2::TimezoneDefiner
-  # Initializes a new TimezoneDefiner.
-  #
-  # @param string_deduper [StringDeduper] a {StringDeduper} instance to use
-  #   when deduping abbreviations.
-  # @return [TimezoneDefiner] a new instance of TimezoneDefiner
-  def initialize(string_deduper); end
-
-  # Returns the first offset to be defined or `nil` if no offsets have been
-  #  defined. The first offset is observed before the time of the first
-  #  transition.
-  #
-  # @return [TimezoneOffset] the first offset to be defined or `nil` if no
-  #   offsets have been defined.
-  def first_offset; end
-
-  # Defines an offset.
-  #
-  # @param id [Symbol] an arbitrary value used identify the offset in
-  #   subsequent calls to transition. It must be unique.
-  # @param base_utc_offset [Integer] the base offset from UTC of the zone in
-  #   seconds. This does not include daylight savings time.
-  # @param std_offset [Integer] the daylight savings offset from the base
-  #   offset in seconds. Typically either 0 or 3600.
-  # @param abbreviation [String] an abbreviation for the offset, for
-  #   example, EST or EDT.
-  # @raise [ArgumentError] if another offset has already been defined with
-  #   the given id.
-  def offset(id, base_utc_offset, std_offset, abbreviation); end
-
-  # Defines the rules that will be used for handling instants after the last
-  # transition.
-  #
-  # This method is currently just a placeholder for forward compatibility
-  # that accepts and ignores any arguments passed.
-  #
-  # Support for subsequent rules will be added in a future version of TZInfo
-  # and the rules will be included in format 2 releases of TZInfo::Data.
-  def subsequent_rules(*args); end
-
-  # Defines a transition to a given offset.
-  #
-  # Transitions must be defined in increasing time order.
-  #
-  # @param offset_id [Symbol] references the id of a previously defined
-  #   offset.
-  # @param timestamp_value [Integer] the time the transition occurs as a
-  #   number of seconds since 1970-01-01 00:00:00 UTC ignoring leap seconds
-  #   (i.e. each day is treated as if it were 86,400 seconds long).
-  # @raise [ArgumentError] if `offset_id` does not reference a defined
-  #   offset.
-  # @raise [ArgumentError] if `timestamp_value` is not greater than the
-  #   `timestamp_value` of the previously defined transition.
-  def transition(offset_id, timestamp_value); end
-
-  # @return [Array<TimezoneTransition>] the defined transitions of the time
-  #   zone.
-  def transitions; end
-end
-
-# {Format2::TimezoneDefinition} is included into format 2 time zone
-# definition modules and provides methods for defining time zones.
-#
-# @private
-module TZInfo::Format2::TimezoneDefinition
-  mixes_in_class_methods ::TZInfo::Format2::TimezoneDefinition::ClassMethods
-
-  class << self
-    # Adds class methods to the includee.
-    #
-    # @param base [Module] the includee.
-    def append_features(base); end
-  end
-end
-
-# Class methods for inclusion.
-#
-# @private
-module TZInfo::Format2::TimezoneDefinition::ClassMethods
-  # @return [TimezoneInfo] the last time zone to be defined.
-  def get; end
-
-  private
-
-  # Defines a linked time zone.
-  #
-  # @param identifier [String] the identifier of the time zone being
-  #   defined.
-  # @param link_to_identifier [String] the identifier the new time zone
-  #   links to (is an alias for).
-  def linked_timezone(identifier, link_to_identifier); end
-
-  # Defines a data time zone.
-  #
-  # @param identifier [String] the identifier of the time zone.
-  # @yield [definer] yields to the caller to define the time zone.
-  # @yieldparam definer [Object] an instance of the class returned by
-  #   {#timezone_definer_class}, typically {TimezoneDefiner}.
-  def timezone(identifier); end
-
-  # @return [Class] the class to be instantiated and yielded by
-  #   {#timezone}.
-  def timezone_definer_class; end
-end
-
-# Instances of {TimezoneIndexDefiner} are yielded by
-# {TimezoneIndexDefinition} to allow the time zone index to be defined.
-#
-# @private
-class TZInfo::Format2::TimezoneIndexDefiner
-  # Initializes a new TimezoneDefiner.
-  #
-  # @param string_deduper [StringDeduper] a {StringDeduper} instance to use
-  #   when deduping identifiers.
-  # @return [TimezoneIndexDefiner] a new instance of TimezoneIndexDefiner
-  def initialize(string_deduper); end
-
-  # Adds a data time zone to the index.
-  #
-  # @param identifier [String] the time zone identifier.
-  def data_timezone(identifier); end
-
-  # @return [Array<String>] the identifiers of all data time zones.
-  def data_timezones; end
-
-  # Adds a linked time zone to the index.
-  #
-  # @param identifier [String] the time zone identifier.
-  def linked_timezone(identifier); end
-
-  # @return [Array<String>] the identifiers of all linked time zones.
-  def linked_timezones; end
-end
-
-# The format 2 time zone index file includes {TimezoneIndexDefinition},
-# which provides the {TimezoneIndexDefinition::ClassMethods#timezone_index
-# timezone_index} method used to define the index.
-#
-# @private
-module TZInfo::Format2::TimezoneIndexDefinition
-  mixes_in_class_methods ::TZInfo::Format2::TimezoneIndexDefinition::ClassMethods
-
-  class << self
-    # Adds class methods to the includee and initializes class instance
-    # variables.
-    #
-    # @param base [Module] the includee.
-    def append_features(base); end
-  end
-end
-
-# Class methods for inclusion.
-#
-# @private
-module TZInfo::Format2::TimezoneIndexDefinition::ClassMethods
-  # @return [Array<String>] a frozen `Array` containing the identifiers of
-  #   all data time zones. Identifiers are sorted according to
-  #   `String#<=>`.
-  def data_timezones; end
-
-  # @return [Array<String>] a frozen `Array` containing the identifiers of
-  #   all linked time zones. Identifiers are sorted according to
-  #   `String#<=>`.
-  def linked_timezones; end
-
-  # Defines the index.
-  #
-  # @yield [definer] yields to the caller to allow the index to be
-  #   defined.
-  # @yieldparam definer [TimezoneIndexDefiner] a {TimezoneIndexDefiner}
-  #   instance that should be used to define the index.
-  def timezone_index; end
-end
-
-# A {Timezone} based on a {DataSources::TimezoneInfo}.
-#
-# @abstract
-class TZInfo::InfoTimezone < ::TZInfo::Timezone
-  # Initializes a new {InfoTimezone}.
-  #
-  # {InfoTimezone} instances should not normally be created directly. Use
-  # the {Timezone.get} method to obtain {Timezone} instances.
-  #
-  # @param info [DataSources::TimezoneInfo] a {DataSources::TimezoneInfo}
-  #   instance supplied by a {DataSource} that will be used as the source of
-  #   data for this {InfoTimezone}.
-  # @return [InfoTimezone] a new instance of InfoTimezone
-  def initialize(info); end
-
-  # @return [String] the identifier of the time zone, for example,
-  #   `"Europe/Paris"`.
-  def identifier; end
-
-  protected
-
-  # @return [DataSources::TimezoneInfo] the {DataSources::TimezoneInfo} this
-  #   {InfoTimezone} is based on.
-  def info; end
-end
-
-# {InvalidCountryCode} is raised by {Country#get} if the code given is not a
-# valid ISO 3166-1 alpha-2 code.
-class TZInfo::InvalidCountryCode < ::StandardError; end
-
-# {InvalidDataSource} is raised if the selected {DataSource} doesn't implement
-# one of the required methods.
-class TZInfo::InvalidDataSource < ::StandardError; end
-
-# {InvalidTimezoneIdentifier} is raised by {Timezone.get} if the identifier
-# given is not valid.
-class TZInfo::InvalidTimezoneIdentifier < ::StandardError; end
-
-# Defines transitions that occur on the one-based nth Julian day of the year.
-#
-# Leap days are not counted. Day 1 is 1 January. Day 60 is always 1 March.
-# Day 365 is always 31 December.
-#
-# @private
-class TZInfo::JulianDayOfYearTransitionRule < ::TZInfo::DayOfYearTransitionRule
-  # Initializes a new {JulianDayOfYearTransitionRule}.
-  #
-  # @param day [Integer] the one-based Julian day of the year on which the
-  #   transition occurs (1 to 365 inclusive).
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @raise [ArgumentError] if `day` is not an `Integer`.
-  # @raise [ArgumentError] if `day` is less than 1 or greater than 365.
-  # @return [JulianDayOfYearTransitionRule] a new instance of JulianDayOfYearTransitionRule
-  def initialize(day, transition_at = T.unsafe(nil)); end
-
-  # Determines if this {JulianDayOfYearTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {JulianDayOfYearTransitionRule} with
-  #   the same {transition_at} and day as this
-  #   {JulianDayOfYearTransitionRule}, otherwise `false`.
-  def ==(r); end
-
-  # Determines if this {JulianDayOfYearTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {JulianDayOfYearTransitionRule} with
-  #   the same {transition_at} and day as this
-  #   {JulianDayOfYearTransitionRule}, otherwise `false`.
-  def eql?(r); end
-
-  # @return [Boolean] `true` if the day specified by this transition is the
-  #   first in the year (a day number of 1), otherwise `false`.
-  def is_always_first_day_of_year?; end
-
-  # @return [Boolean] `true` if the day specified by this transition is the
-  #   last in the year (a day number of 365), otherwise `false`.
-  def is_always_last_day_of_year?; end
-
-  protected
-
-  # Returns a `Time` representing midnight local time on the day specified by
-  # the rule for the given offset and year.
-  #
-  # @param offset [TimezoneOffset] the current offset at the time of the
-  #   transition.
-  # @param year [Integer] the year in which the transition occurs.
-  # @return [Time] midnight local time on the day specified by the rule for
-  #   the given offset and year.
-  def get_day(offset, year); end
-
-  # @return [Array] an `Array` of parameters that will influence the output of
-  #   {hash}.
-  def hash_args; end
-end
-
-# The 60 days in seconds.
-TZInfo::JulianDayOfYearTransitionRule::LEAP = T.let(T.unsafe(nil), Integer)
-
-# The length of a non-leap year in seconds.
-TZInfo::JulianDayOfYearTransitionRule::YEAR = T.let(T.unsafe(nil), Integer)
-
-# A rule that transitions on the last occurrence of a particular day of week
-# of a calendar month.
-#
-# @private
-class TZInfo::LastDayOfMonthTransitionRule < ::TZInfo::DayOfWeekTransitionRule
-  # Initializes a new {LastDayOfMonthTransitionRule}.
-  #
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @param day_of_week [Integer] the day of the week when the transition
-  #   occurs. 0 is Sunday, 6 is Saturday.
-  # @param month [Integer] the month of the year when the transition occurs.
-  # @raise [ArgumentError] if `day_of_week` is not an `Integer`.
-  # @raise [ArgumentError] if `day_of_week` is less than 0 or greater than 6.
-  # @raise [ArgumentError] if `month` is not an `Integer`.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @raise [ArgumentError] if `month` is less than 1 or greater than 12.
-  # @return [LastDayOfMonthTransitionRule] a new instance of LastDayOfMonthTransitionRule
-  def initialize(month, day_of_week, transition_at = T.unsafe(nil)); end
-
-  # Determines if this {LastDayOfMonthTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {LastDayOfMonthTransitionRule} with
-  #   the same {transition_at}, month and day of week as this
-  #   {LastDayOfMonthTransitionRule}, otherwise `false`.
-  def ==(r); end
-
-  # Determines if this {LastDayOfMonthTransitionRule} is equal to another
-  # instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {LastDayOfMonthTransitionRule} with
-  #   the same {transition_at}, month and day of week as this
-  #   {LastDayOfMonthTransitionRule}, otherwise `false`.
-  def eql?(r); end
-
-  protected
-
-  # Returns a `Time` representing midnight local time on the day specified by
-  # the rule for the given offset and year.
-  #
-  # @param offset [TimezoneOffset] the current offset at the time of the
-  #   transition.
-  # @param year [Integer] the year in which the transition occurs.
-  # @return [Time] midnight local time on the day specified by the rule for
-  #   the given offset and year.
-  def get_day(offset, year); end
-end
-
-# Represents time zones that are defined as a link to or alias for another
-# time zone.
-class TZInfo::LinkedTimezone < ::TZInfo::InfoTimezone
-  # Initializes a new {LinkedTimezone}.
-  #
-  # {LinkedTimezone} instances should not normally be created directly. Use
-  # the {Timezone.get} method to obtain {Timezone} instances.
-  #
-  # @param info [DataSources::LinkedTimezoneInfo] a
-  #   {DataSources::LinkedTimezoneInfo} instance supplied by a {DataSource}
-  #   that will be used as the source of data for this {LinkedTimezone}.
-  # @return [LinkedTimezone] a new instance of LinkedTimezone
-  def initialize(info); end
-
-  # Returns the canonical {Timezone} instance for this {LinkedTimezone}.
-  #
-  # For a {LinkedTimezone}, this is the canonical zone of the link target.
-  #
-  # @return [Timezone] the canonical {Timezone} instance for this {Timezone}.
-  def canonical_zone; end
-
-  # Returns the {TimezonePeriod} that is valid at a given time.
-  #
-  # Unlike {period_for_local} and {period_for_utc}, the UTC offset of the
-  # `time` parameter is taken into consideration.
-  #
-  # @param time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified
-  #   offset.
-  # @return [TimezonePeriod] the {TimezonePeriod} that is valid at `time`.
-  def period_for(time); end
-
-  # Returns the set of {TimezonePeriod}s that are valid for the given
-  # local time as an `Array`.
-  #
-  # The UTC offset of the `local_time` parameter is ignored (it is treated as
-  # a time in the time zone represented by `self`).
-  #
-  # This will typically return an `Array` containing a single
-  # {TimezonePeriod}. More than one {TimezonePeriod} will be returned when the
-  # local time is ambiguous (for example, when daylight savings time ends). An
-  # empty `Array` will be returned when the local time is not valid (for
-  # example, when daylight savings time begins).
-  #
-  # To obtain just a single {TimezonePeriod} in all cases, use
-  # {period_for_local} instead and specify how ambiguities should be resolved.
-  #
-  # @param local_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `local_time` is `nil`.
-  # @return [Array<TimezonePeriod>] the set of {TimezonePeriod}s that are
-  #   valid at `local_time`.
-  def periods_for_local(local_time); end
-
-  # Returns an `Array` of {TimezoneTransition} instances representing the
-  # times where the UTC offset of the timezone changes.
-  #
-  # Transitions are returned up to a given time (`to`).
-  #
-  # A from time may also be supplied using the `from` parameter. If from is
-  # not `nil`, only transitions from that time onwards will be returned.
-  #
-  # Comparisons with `to` are exclusive. Comparisons with `from` are
-  # inclusive. If a transition falls precisely on `to`, it will be excluded.
-  # If a transition falls on `from`, it will be included.
-  #
-  # @param to [Object] a `Time`, `DateTime` or {Timestamp} specifying the
-  #   latest (exclusive) transition to return.
-  # @param from [Object] an optional `Time`, `DateTime` or {Timestamp}
-  #   specifying the earliest (inclusive) transition to return.
-  # @raise [ArgumentError] if `from` is specified and `to` is not greater than
-  #   `from`.
-  # @raise [ArgumentError] is raised if `to` is `nil`.
-  # @raise [ArgumentError] if either `to` or `from` is a {Timestamp} with an
-  #   unspecified offset.
-  # @return [Array<TimezoneTransition>] the transitions that are earlier than
-  #   `to` and, if specified, at or later than `from`. Transitions are ordered
-  #   by when they occur, from earliest to latest.
-  def transitions_up_to(to, from = T.unsafe(nil)); end
-end
-
-# Represents the infinite period of time in a time zone that constantly
-# observes the same offset from UTC (has an unbounded start and end).
-class TZInfo::OffsetTimezonePeriod < ::TZInfo::TimezonePeriod
-  # Initializes an {OffsetTimezonePeriod}.
-  #
-  # @param offset [TimezoneOffset] the offset that is constantly observed.
-  # @raise [ArgumentError] if `offset` is `nil`.
-  # @return [OffsetTimezonePeriod] a new instance of OffsetTimezonePeriod
-  def initialize(offset); end
-
-  # Determines if this {OffsetTimezonePeriod} is equal to another instance.
-  #
-  # @param p [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `p` is a {OffsetTimezonePeriod} with the same
-  #   {offset}, otherwise `false`.
-  def ==(p); end
-
-  # @return [TimezoneTransition] the transition that defines the end of this
-  #   {TimezonePeriod}, always `nil` for {OffsetTimezonePeriod}.
-  def end_transition; end
-
-  # Determines if this {OffsetTimezonePeriod} is equal to another instance.
-  #
-  # @param p [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `p` is a {OffsetTimezonePeriod} with the same
-  #   {offset}, otherwise `false`.
-  def eql?(p); end
-
-  # @return [Integer] a hash based on {offset}.
-  def hash; end
-
-  # @return [TimezoneTransition] the transition that defines the start of this
-  #   {TimezonePeriod}, always `nil` for {OffsetTimezonePeriod}.
-  def start_transition; end
-end
-
-# {PeriodNotFound} is raised to indicate that no {TimezonePeriod} matching a
-# given time could be found.
-class TZInfo::PeriodNotFound < ::StandardError; end
-
-# Maintains a pool of `String` instances. The {#dedupe} method will return
-# either a pooled copy of a given `String` or add the instance to the pool.
-#
-# @private
-class TZInfo::StringDeduper
-  # Initializes a new {StringDeduper}.
-  #
-  # @return [StringDeduper] a new instance of StringDeduper
-  def initialize; end
-
-  # @param string [String] the string to deduplicate.
-  # @return [bool] `string` if it is frozen, otherwise a frozen, possibly
-  #   pre-existing copy of `string`.
-  def dedupe(string); end
-
-  protected
-
-  # Creates a `Hash` to store pooled `String` instances.
-  #
-  # @param block [Proc] Default value block to be passed to `Hash.new`.
-  # @return [Hash] a `Hash` to store pooled `String` instances.
-  def create_hash(&block); end
-
-  class << self
-    # @return [StringDeduper] a globally available singleton instance of
-    #   {StringDeduper}. This instance is safe for use in concurrently
-    #   executing threads.
-    def global; end
-  end
-end
-
-# A subclass of `Time` used to represent local times. {TimeWithOffset} holds a
-# reference to the related {TimezoneOffset} and overrides various methods to
-# return results appropriate for the {TimezoneOffset}. Certain operations will
-# clear the associated {TimezoneOffset} (if the {TimezoneOffset} would not
-# necessarily be valid for the result). Once the {TimezoneOffset} has been
-# cleared, {TimeWithOffset} behaves identically to `Time`.
-#
-# Arithmetic performed on {TimeWithOffset} instances is _not_ time zone-aware.
-# Regardless of whether transitions in the time zone are crossed, results of
-# arithmetic operations will always maintain the same offset from UTC
-# (`utc_offset`). The associated {TimezoneOffset} will aways be cleared.
-class TZInfo::TimeWithOffset < ::Time
-  include ::TZInfo::WithOffset
-
-  # An overridden version of `Time#dst?` that, if there is an associated
-  # {TimezoneOffset}, returns the result of calling {TimezoneOffset#dst? dst?}
-  # on that offset.
-  #
-  # @return [Boolean] `true` if daylight savings time is being observed,
-  #   otherwise `false`.
-  def dst?; end
-
-  # An overridden version of `Time#getlocal` that clears the associated
-  # {TimezoneOffset} if the base implementation of `getlocal` returns a
-  # {TimeWithOffset}.
-  #
-  # @return [Time] a representation of the {TimeWithOffset} using either the
-  #   local time zone or the given offset.
-  def getlocal(*args); end
-
-  # An overridden version of `Time#gmtime` that clears the associated
-  # {TimezoneOffset}.
-  #
-  # @return [TimeWithOffset] `self`.
-  def gmtime; end
-
-  # An overridden version of `Time#dst?` that, if there is an associated
-  # {TimezoneOffset}, returns the result of calling {TimezoneOffset#dst? dst?}
-  # on that offset.
-  #
-  # @return [Boolean] `true` if daylight savings time is being observed,
-  #   otherwise `false`.
-  def isdst; end
-
-  # An overridden version of `Time#localtime` that clears the associated
-  # {TimezoneOffset}.
-  #
-  # @return [TimeWithOffset] `self`.
-  def localtime(*args); end
-
-  # An overridden version of `Time#round` that, if there is an associated
-  # {TimezoneOffset}, returns a {TimeWithOffset} preserving that offset.
-  #
-  # @return [Time] the rounded time.
-  def round(ndigits = T.unsafe(nil)); end
-
-  # Marks this {TimeWithOffset} as a local time with the UTC offset of a given
-  # {TimezoneOffset} and sets the associated {TimezoneOffset}.
-  #
-  # @param timezone_offset [TimezoneOffset] the {TimezoneOffset} to use to set
-  #   the offset of this {TimeWithOffset}.
-  # @raise [ArgumentError] if `timezone_offset` is `nil`.
-  # @return [TimeWithOffset] `self`.
-  def set_timezone_offset(timezone_offset); end
-
-  # @return [TimezoneOffset] the {TimezoneOffset} associated with this
-  #   instance.
-  def timezone_offset; end
-
-  # An overridden version of `Time#to_a`. The `isdst` (index 8) and `zone`
-  # (index 9) elements of the array are set according to the associated
-  # {TimezoneOffset}.
-  #
-  # @return [Array] an `Array` representation of the {TimeWithOffset}.
-  def to_a; end
-
-  # An overridden version of `Time#to_datetime` that, if there is an
-  # associated {TimezoneOffset}, returns a {DateTimeWithOffset} with that
-  # offset.
-  #
-  # @return [DateTime] if there is an associated {TimezoneOffset}, a
-  #   {DateTimeWithOffset} representation of this {TimeWithOffset}, otherwise
-  #   a `Time` representation.
-  def to_datetime; end
-
-  # An overridden version of `Time#utc` that clears the associated
-  # {TimezoneOffset}.
-  #
-  # @return [TimeWithOffset] `self`.
-  def utc; end
-
-  # An overridden version of `Time#zone` that, if there is an associated
-  # {TimezoneOffset}, returns the {TimezoneOffset#abbreviation abbreviation}
-  # of that offset.
-  #
-  # @return [String] the {TimezoneOffset#abbreviation abbreviation} of the
-  #   associated {TimezoneOffset}, or the result from `Time#zone` if there is
-  #   no such offset.
-  def zone; end
-
-  protected
-
-  # Clears the associated {TimezoneOffset}.
-  #
-  # @return [TimeWithOffset] `self`.
-  def clear_timezone_offset; end
-end
-
-# A time represented as an `Integer` number of seconds since 1970-01-01
-# 00:00:00 UTC (ignoring leap seconds and using the proleptic Gregorian
-# calendar), the fraction through the second (sub_second as a `Rational`) and
-# an optional UTC offset. Like Ruby's `Time` class, {Timestamp} can
-# distinguish between a local time with a zero offset and a time specified
-# explicitly as UTC.
-class TZInfo::Timestamp
-  include ::Comparable
-
-  # Initializes a new {Timestamp}.
-  #
-  # @param value [Integer] the number of seconds since 1970-01-01 00:00:00 UTC
-  #   ignoring leap seconds.
-  # @param utc_offset [Object] either `nil` for a {Timestamp} without a
-  #   specified offset, an offset from UTC specified as an `Integer` number of
-  #   seconds or the `Symbol` `:utc`).
-  # @param sub_second [Numeric] the fractional part of the second as either a
-  #   `Rational` that is greater than or equal to 0 and less than 1, or
-  #   the `Integer` 0.
-  # @raise [ArgumentError] if `utc_offset` is not `nil`, not an `Integer` and
-  #   not the `Symbol` `:utc`.
-  # @raise [ArgumentError] if `sub_second` is not a `Rational`, or the
-  #   `Integer` 0.
-  # @raise [ArgumentError] if `value` is not an `Integer`.
-  # @raise [RangeError] if `sub_second` is a `Rational` but that is less
-  #   than 0 or greater than or equal to 1.
-  # @return [Timestamp] a new instance of Timestamp
-  def initialize(value, sub_second = T.unsafe(nil), utc_offset = T.unsafe(nil)); end
-
-  # Compares this {Timestamp} with another.
-  #
-  # {Timestamp} instances without a defined UTC offset are not comparable with
-  # {Timestamp} instances that have a defined UTC offset.
-  #
-  # @param t [Timestamp] the {Timestamp} to compare this instance with.
-  # @return [Integer] -1, 0 or 1 depending if this instance is earlier, equal
-  #   or later than `t` respectively. Returns `nil` when comparing a
-  #   {Timestamp} that does not have a defined UTC offset with a {Timestamp}
-  #   that does have a defined UTC offset. Returns `nil` if `t` is not a
-  #   {Timestamp}.
-  def <=>(t); end
-
-  # Adds a number of seconds to the {Timestamp} value, setting the UTC offset
-  # of the result.
-  #
-  # @param seconds [Integer] the number of seconds to be added.
-  # @param utc_offset [Object] either `nil` for a {Timestamp} without a
-  #   specified offset, an offset from UTC specified as an `Integer` number of
-  #   seconds or the `Symbol` `:utc`).
-  # @raise [ArgumentError] if `seconds` is not an `Integer`.
-  # @raise [ArgumentError] if `utc_offset` is not `nil`, not an `Integer` and
-  #   not the `Symbol` `:utc`.
-  # @return [Timestamp] the result of adding `seconds` to the
-  #   {Timestamp} value as a new {Timestamp} instance with the chosen
-  #   `utc_offset`.
-  def add_and_set_utc_offset(seconds, utc_offset); end
-
-  def eql?(_arg0); end
-
-  # @return [Integer] a hash based on the value, sub-second and whether there
-  #   is a defined UTC offset.
-  def hash; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # Formats this {Timestamp} according to the directives in the given format
-  # string.
-  #
-  # @param format [String] the format string. Please refer to `Time#strftime`
-  #   for a list of supported format directives.
-  # @raise [ArgumentError] if `format` is not specified.
-  # @return [String] the formatted {Timestamp}.
-  def strftime(format); end
-
-  # @return [Numeric] the fraction of a second elapsed since timestamp as
-  #   either a `Rational` or the `Integer` 0. Always greater than or equal to
-  #   0 and less than 1.
-  def sub_second; end
-
-  # Converts this {Timestamp} to a Gregorian `DateTime`.
-  #
-  # @return [DateTime] a Gregorian `DateTime` representation of this
-  #   {Timestamp}. If the UTC offset of this {Timestamp} is not specified, a
-  #   UTC `DateTime` will be returned.
-  def to_datetime; end
-
-  # Converts this {Timestamp} to an `Integer` number of seconds since
-  # 1970-01-01 00:00:00 UTC (ignoring leap seconds).
-  #
-  # @return [Integer] an `Integer` representation of this {Timestamp} (the
-  #   number of seconds since 1970-01-01 00:00:00 UTC ignoring leap seconds).
-  def to_i; end
-
-  # @return [String] a `String` representation of this {Timestamp}.
-  def to_s; end
-
-  # Converts this {Timestamp} to a `Time`.
-  #
-  # @return [Time] a `Time` representation of this {Timestamp}. If the UTC
-  #   offset of this {Timestamp} is not specified, a UTC `Time` will be
-  #   returned.
-  def to_time; end
-
-  # @return [Timestamp] a UTC {Timestamp} equivalent to this instance. Returns
-  #   `self` if {#utc? self.utc?} is `true`.
-  def utc; end
-
-  # @return [Boolean] `true` if this {Timestamp} represents UTC, `false` if
-  #   the {Timestamp} wasn't specified as UTC or `nil` if the {Timestamp} has
-  #   no specified offset.
-  def utc?; end
-
-  # @return [Integer] the offset from UTC in seconds or `nil` if the
-  #   {Timestamp} doesn't have a specified offset.
-  def utc_offset; end
-
-  # @return [Integer] the number of seconds since 1970-01-01 00:00:00 UTC
-  #   ignoring leap seconds (i.e. each day is treated as if it were 86,400
-  #   seconds long).
-  def value; end
-
-  protected
-
-  # Constructs a new instance of a `DateTime` or `DateTime`-like class with
-  # the same {value}, {sub_second} and {utc_offset} as this {Timestamp}.
-  #
-  # @param klass [Class] the class to instantiate.
-  # @private
-  def new_datetime(klass = T.unsafe(nil)); end
-
-  # Creates a new instance of a `Time` or `Time`-like class matching the
-  # {value} and {sub_second} of this {Timestamp}, but not setting the offset.
-  #
-  # @param klass [Class] the class to instantiate.
-  # @private
-  def new_time(klass = T.unsafe(nil)); end
-
-  private
-
-  # Initializes a new {Timestamp} without validating the parameters. This
-  # method is used internally within {Timestamp} to avoid the overhead of
-  # checking parameters.
-  #
-  # @param value [Integer] the number of seconds since 1970-01-01 00:00:00 UTC
-  #   ignoring leap seconds.
-  # @param sub_second [Numeric] the fractional part of the second as either a
-  #   `Rational` that is greater than or equal to 0 and less than 1, or the
-  #   `Integer` 0.
-  # @param utc_offset [Object] either `nil` for a {Timestamp} without a
-  #   specified offset, an offset from UTC specified as an `Integer` number of
-  #   seconds or the `Symbol` `:utc`).
-  def initialize!(value, sub_second = T.unsafe(nil), utc_offset = T.unsafe(nil)); end
-
-  # Converts the {sub_second} value to a `String` suitable for appending to
-  # the `String` representation of a {Timestamp}.
-  #
-  # @return [String] a `String` representation of {sub_second}.
-  def sub_second_to_s; end
-
-  # Converts the value and sub-seconds to a `String`, adding on the given
-  # offset.
-  #
-  # @param offset [Integer] the offset to add to the value.
-  # @return [String] the value and sub-seconds.
-  def value_and_sub_second_to_s(offset = T.unsafe(nil)); end
-
-  class << self
-    # Returns a new {Timestamp} representing the (proleptic Gregorian
-    # calendar) date and time specified by the supplied parameters.
-    #
-    # If `utc_offset` is `nil`, `:utc` or 0, the date and time parameters will
-    # be interpreted as representing a UTC date and time. Otherwise the date
-    # and time parameters will be interpreted as a local date and time with
-    # the given offset.
-    #
-    # @param month [Integer] the month (1-12).
-    # @param day [Integer] the day of the month (1-31).
-    # @param hour [Integer] the hour (0-23).
-    # @param minute [Integer] the minute (0-59).
-    # @param second [Integer] the second (0-59).
-    # @param sub_second [Numeric] the fractional part of the second as either
-    #   a `Rational` that is greater than or equal to 0 and less than 1, or
-    #   the `Integer` 0.
-    # @param utc_offset [Object] either `nil` for a {Timestamp} without a
-    #   specified offset, an offset from UTC specified as an `Integer` number
-    #   of seconds or the `Symbol` `:utc`).
-    # @param year [Integer] the year.
-    # @raise [RangeError] if `sub_second` is a `Rational` but that is less
-    #   than 0 or greater than or equal to 1.
-    # @raise [ArgumentError] if `sub_second` is not a `Rational`, or the
-    #   `Integer` 0.
-    # @raise [ArgumentError] if either of `year`, `month`, `day`, `hour`,
-    #   `minute`, or `second` is not an `Integer`.
-    # @raise [ArgumentError] if `utc_offset` is not `nil`, not an `Integer`
-    #   and not the `Symbol` `:utc`.
-    # @raise [RangeError] if `month` is not between 1 and 12.
-    # @raise [RangeError] if `day` is not between 1 and 31.
-    # @raise [RangeError] if `hour` is not between 0 and 23.
-    # @raise [RangeError] if `minute` is not between 0 and 59.
-    # @raise [RangeError] if `second` is not between 0 and 59.
-    # @return [Timestamp] a new {Timestamp} representing the specified
-    #   (proleptic Gregorian calendar) date and time.
-    def create(year, month = T.unsafe(nil), day = T.unsafe(nil), hour = T.unsafe(nil), minute = T.unsafe(nil), second = T.unsafe(nil), sub_second = T.unsafe(nil), utc_offset = T.unsafe(nil)); end
-
-    # When used without a block, returns a {Timestamp} representation of a
-    # given `Time`, `DateTime` or {Timestamp}.
-    #
-    # When called with a block, the {Timestamp} representation of `value` is
-    # passed to the block. The block must then return a {Timestamp}, which
-    # will be converted back to the type of the initial value. If the initial
-    # value was a {Timestamp}, the block result will be returned. If the
-    # initial value was a `DateTime`, a Gregorian `DateTime` will be returned.
-    #
-    # The UTC offset of `value` can either be preserved (the {Timestamp}
-    # representation will have the same UTC offset as `value`), ignored (the
-    # {Timestamp} representation will have no defined UTC offset), or treated
-    # as though it were UTC (the {Timestamp} representation will have a
-    # {utc_offset} of 0 and {utc?} will return `true`).
-    #
-    # @param value [Object] a `Time`, `DateTime` or {Timestamp}.
-    # @param offset [Symbol] either `:preserve` to preserve the offset of
-    #   `value`, `:ignore` to ignore the offset of `value` and create a
-    #   {Timestamp} with an unspecified offset, or `:treat_as_utc` to treat
-    #   the offset of `value` as though it were UTC and create a UTC
-    #   {Timestamp}.
-    # @raise [ArgumentError]
-    # @return [Object] if called without a block, the {Timestamp}
-    #   representation of `value`, otherwise the result of the block,
-    #   converted back to the type of `value`.
-    # @yield [timestamp] if a block is provided, the {Timestamp}
-    #   representation is passed to the block.
-    # @yieldparam timestamp [Timestamp] the {Timestamp} representation of
-    #   `value`.
-    # @yieldreturn [Timestamp] a {Timestamp} to be converted back to the type
-    #   of `value`.
-    def for(value, offset = T.unsafe(nil)); end
-
-    # Creates a new UTC {Timestamp}.
-    #
-    # @param value [Integer] the number of seconds since 1970-01-01 00:00:00
-    #   UTC ignoring leap seconds.
-    # @param sub_second [Numeric] the fractional part of the second as either
-    #   a `Rational` that is greater than or equal to 0 and less than 1, or
-    #   the `Integer` 0.
-    # @raise [ArgumentError] if `value` is not an `Integer`.
-    # @raise [ArgumentError] if `sub_second` is not a `Rational`, or the
-    #   `Integer` 0.
-    # @raise [RangeError] if `sub_second` is a `Rational` but that is less
-    #   than 0 or greater than or equal to 1.
-    def utc(value, sub_second = T.unsafe(nil)); end
-
-    private
-
-    # Creates a {Timestamp} that represents a given `DateTime`, optionally
-    # ignoring the offset.
-    #
-    # @param datetime [DateTime] a `DateTime`.
-    # @param ignore_offset [Boolean] whether to ignore the offset of
-    #   `datetime`.
-    # @param target_utc_offset [Object] if `ignore_offset` is `true`, the UTC
-    #   offset of the result (`:utc`, `nil` or an `Integer`).
-    # @return [Timestamp] the {Timestamp} representation of `datetime`.
-    def for_datetime(datetime, ignore_offset, target_utc_offset); end
-
-    # Creates a {Timestamp} that represents a given `Time`, optionally
-    # ignoring the offset.
-    #
-    # @param time [Time] a `Time`.
-    # @param ignore_offset [Boolean] whether to ignore the offset of `time`.
-    # @param target_utc_offset [Object] if `ignore_offset` is `true`, the UTC
-    #   offset of the result (`:utc`, `nil` or an `Integer`).
-    # @return [Timestamp] the {Timestamp} representation of `time`.
-    def for_time(time, ignore_offset, target_utc_offset); end
-
-    # Creates a {Timestamp} that represents a given `Time`-like object,
-    # optionally ignoring the offset (if the `time_like` responds to
-    # `utc_offset`).
-    #
-    # @param time_like [Object] a `Time`-like object.
-    # @param ignore_offset [Boolean] whether to ignore the offset of `time`.
-    # @param target_utc_offset [Object] if `ignore_offset` is `true`, the UTC
-    #   offset of the result (`:utc`, `nil` or an `Integer`).
-    # @return [Timestamp] the {Timestamp} representation of `time_like`.
-    def for_time_like(time_like, ignore_offset, target_utc_offset); end
-
-    # Returns a {Timestamp} that represents another {Timestamp}, optionally
-    # ignoring the offset. If the result would be identical to `value`, the
-    # same instance is returned. If the passed in value is an instance of a
-    # subclass of {Timestamp}, then a new {Timestamp} will always be returned.
-    #
-    # @param timestamp [Timestamp] a {Timestamp}.
-    # @param ignore_offset [Boolean] whether to ignore the offset of
-    #   `timestamp`.
-    # @param target_utc_offset [Object] if `ignore_offset` is `true`, the UTC
-    #   offset of the result (`:utc`, `nil` or an `Integer`).
-    # @return [Timestamp] a [Timestamp] representation of `timestamp`.
-    def for_timestamp(timestamp, ignore_offset, target_utc_offset); end
-
-    # Determines if an object is like a `Time` (for the purposes of converting
-    # to a {Timestamp} with {for}), responding to `to_i` and `subsec`.
-    #
-    # @param value [Object] an object to test.
-    # @return [Boolean] `true` if the object is `Time`-like, otherwise
-    #   `false`.
-    def is_time_like?(value); end
-
-    # Constructs a new instance of `self` (i.e. {Timestamp} or a subclass of
-    # {Timestamp}) without validating the parameters. This method is used
-    # internally within {Timestamp} to avoid the overhead of checking
-    # parameters.
-    #
-    # @param value [Integer] the number of seconds since 1970-01-01 00:00:00
-    #   UTC ignoring leap seconds.
-    # @param sub_second [Numeric] the fractional part of the second as either
-    #   a `Rational` that is greater than or equal to 0 and less than 1, or
-    #   the `Integer` 0.
-    # @param utc_offset [Object] either `nil` for a {Timestamp} without a
-    #   specified offset, an offset from UTC specified as an `Integer` number
-    #   of seconds or the `Symbol` `:utc`).
-    # @return [Timestamp] a new instance of `self`.
-    def new!(value, sub_second = T.unsafe(nil), utc_offset = T.unsafe(nil)); end
-  end
-end
-
-# The Unix epoch (1970-01-01 00:00:00 UTC) as a chronological Julian day
-# number.
-TZInfo::Timestamp::JD_EPOCH = T.let(T.unsafe(nil), Integer)
-
-# A subclass of {Timestamp} used to represent local times.
-# {TimestampWithOffset} holds a reference to the related {TimezoneOffset} and
-# overrides various methods to return results appropriate for the
-# {TimezoneOffset}. Certain operations will clear the associated
-# {TimezoneOffset} (if the {TimezoneOffset} would not necessarily be valid for
-# the result). Once the {TimezoneOffset} has been cleared,
-# {TimestampWithOffset} behaves identically to {Timestamp}.
-class TZInfo::TimestampWithOffset < ::TZInfo::Timestamp
-  include ::TZInfo::WithOffset
-
-  # Sets the associated {TimezoneOffset} of this {TimestampWithOffset}.
-  #
-  # @param timezone_offset [TimezoneOffset] a {TimezoneOffset} valid at the time
-  #   and for the offset of this {TimestampWithOffset}.
-  # @raise [ArgumentError] if `timezone_offset` is `nil`.
-  # @raise [ArgumentError] if {utc? self.utc?} is `true`.
-  # @raise [ArgumentError] if `timezone_offset.observed_utc_offset` does not equal
-  #   `self.utc_offset`.
-  # @return [TimestampWithOffset] `self`.
-  def set_timezone_offset(timezone_offset); end
-
-  # @return [TimezoneOffset] the {TimezoneOffset} associated with this
-  #   instance.
-  def timezone_offset; end
-
-  # An overridden version of {Timestamp#to_datetime}, if there is an
-  # associated {TimezoneOffset}, returns a {DateTimeWithOffset} with that
-  # offset.
-  #
-  # @return [DateTime] if there is an associated {TimezoneOffset}, a
-  #   {DateTimeWithOffset} representation of this {TimestampWithOffset},
-  #   otherwise a `DateTime` representation.
-  def to_datetime; end
-
-  # An overridden version of {Timestamp#to_time} that, if there is an
-  # associated {TimezoneOffset}, returns a {TimeWithOffset} with that offset.
-  #
-  # @return [Time] if there is an associated {TimezoneOffset}, a
-  #   {TimeWithOffset} representation of this {TimestampWithOffset}, otherwise
-  #   a `Time` representation.
-  def to_time; end
-
-  class << self
-    # Creates a new {TimestampWithOffset} from a given {Timestamp} and
-    # {TimezoneOffset}.
-    #
-    # time of `timestamp`.
-    #
-    # @param timestamp [Timestamp] a {Timestamp}.
-    # @param timezone_offset [TimezoneOffset] a {TimezoneOffset} valid at the
-    # @raise [ArgumentError] if `timestamp` or `timezone_offset` is `nil`.
-    # @return [TimestampWithOffset] a {TimestampWithOffset} that has the same
-    #   {value value} and {sub_second sub_second} as the `timestamp` parameter,
-    #   a {utc_offset utc_offset} equal to the
-    #   {TimezoneOffset#observed_utc_offset observed_utc_offset} of the
-    #   `timezone_offset` parameter and {timezone_offset timezone_offset} set to
-    #   the `timezone_offset` parameter.
-    def set_timezone_offset(timestamp, timezone_offset); end
-  end
-end
-
-# The {Timezone} class represents a time zone. It provides a factory method,
-# {get}, to retrieve {Timezone} instances by their identifier.
-#
-# The {Timezone#to_local} method can be used to convert `Time` and `DateTime`
-# instances to the local time for the zone. For example:
-#
-#     tz = TZInfo::Timezone.get('America/New_York')
-#     local_time = tz.to_local(Time.utc(2005,8,29,15,35,0))
-#     local_datetime = tz.to_local(DateTime.new(2005,8,29,15,35,0))
-#
-# Local `Time` and `DateTime` instances returned by `Timezone` have the
-# correct local offset.
-#
-# The {Timezone#local_to_utc} method can by used to convert local `Time` and
-# `DateTime` instances to UTC. {Timezone#local_to_utc} ignores the UTC offset
-# of the supplied value and treats if it is a local time for the zone. For
-# example:
-#
-#     tz = TZInfo::Timezone.get('America/New_York')
-#     utc_time = tz.local_to_utc(Time.new(2005,8,29,11,35,0))
-#     utc_datetime = tz.local_to_utc(DateTime.new(2005,8,29,11,35,0))
-#
-# Each time zone is treated as sequence of periods of time ({TimezonePeriod})
-# that observe the same offset ({TimezoneOffset}). Transitions
-# ({TimezoneTransition}) denote the end of one period and the start of the
-# next. The {Timezone} class has methods that allow the periods, offsets and
-# transitions of a time zone to be interrogated.
-#
-# All methods that take `Time` objects as parameters can be used with
-# arbitrary `Time`-like objects that respond to both `to_i` and `subsec` and
-# optionally `utc_offset`.
-#
-# The {Timezone} class is thread-safe. It is safe to use class and instance
-# methods of {Timezone} in concurrently executing threads. Instances of
-# {Timezone} can be shared across thread boundaries.
-#
-# The IANA Time Zone Database maintainers recommend that time zone identifiers
-# are not made visible to end-users (see [Names of
-# timezones](https://data.iana.org/time-zones/theory.html#naming)). The
-# {Country} class can be used to obtain lists of time zones by country,
-# including user-friendly descriptions and approximate locations.
-#
-# @abstract The {get} method returns an instance of either {DataTimezone} or
-#   {LinkedTimezone}. The {get_proxy} method and other methods returning
-#   collections of time zones return instances of {TimezoneProxy}.
-class TZInfo::Timezone
-  include ::Comparable
-
-  # Compares this {Timezone} with another based on the {identifier}.
-  #
-  # @param tz [Object] an `Object` to compare this {Timezone} with.
-  # @return [Integer] -1 if `tz` is less than `self`, 0 if `tz` is equal to
-  #   `self` and +1 if `tz` is greater than `self`, or `nil` if `tz` is not an
-  #   instance of {Timezone}.
-  def <=>(tz); end
-
-  # Matches `regexp` against the {identifier} of this {Timezone}.
-  #
-  # @param regexp [Regexp] a `Regexp` to match against the {identifier} of
-  #   this {Timezone}.
-  # @return [Integer] the position the match starts, or `nil` if there is no
-  #   match.
-  def =~(regexp); end
-
-  # Returns a serialized representation of this {Timezone}. This method is
-  # called when using `Marshal.dump` with an instance of {Timezone}.
-  #
-  # @param limit [Integer] the maximum depth to dump - ignored.
-  # @return [String] a serialized representation of this {Timezone}.
-  def _dump(limit); end
-
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [String] the abbreviation of this {Timezone} at the given time.
-  def abbr(time = T.unsafe(nil)); end
-
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [String] the abbreviation of this {Timezone} at the given time.
-  def abbreviation(time = T.unsafe(nil)); end
-
-  # Returns the base offset from UTC in seconds at the given time. This does
-  # not include any adjustment made for daylight savings time and will
-  # typically remain constant throughout the year.
-  #
-  # To obtain the observed offset from UTC, including the effect of daylight
-  # savings time, use {observed_utc_offset} instead.
-  #
-  # If you require accurate {base_utc_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of
-  # {base_utc_offset} has to be derived from changes to the observed UTC
-  # offset and DST status since it is not included in zoneinfo files.
-  #
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [Integer] the base offset from UTC in seconds at the given time.
-  def base_utc_offset(time = T.unsafe(nil)); end
-
-  # Returns the canonical identifier of this time zone.
-  #
-  # This is a shortcut for calling `canonical_zone.identifier`. Please refer
-  # to the {canonical_zone} documentation for further information.
-  #
-  # @return [String] the canonical identifier of this time zone.
-  def canonical_identifier; end
-
-  # Returns the canonical {Timezone} instance for this {Timezone}.
-  #
-  # The IANA Time Zone database contains two types of definition: Zones and
-  # Links. Zones are defined by rules that set out when transitions occur.
-  # Links are just references to fully defined Zone, creating an alias for
-  # that Zone.
-  #
-  # Links are commonly used where a time zone has been renamed in a release of
-  # the Time Zone database. For example, the US/Eastern Zone was renamed as
-  # America/New_York. A US/Eastern Link was added in its place, linking to
-  # (and creating an alias for) America/New_York.
-  #
-  # Links are also used for time zones that are currently identical to a full
-  # Zone, but that are administered separately. For example, Europe/Vatican is
-  # a Link to (and alias for) Europe/Rome.
-  #
-  # For a full Zone (implemented by {DataTimezone}), {canonical_zone} returns
-  # self.
-  #
-  # For a Link (implemented by {LinkedTimezone}), {canonical_zone} returns a
-  # {Timezone} instance representing the full Zone that the link targets.
-  #
-  # TZInfo can be used with different data sources (see the documentation for
-  # {TZInfo::DataSource}). Some DataSource implementations may not support
-  # distinguishing between full Zones and Links and will treat all time zones
-  # as full Zones. In this case, {canonical_zone} will always return `self`.
-  #
-  # There are two built-in DataSource implementations.
-  # {DataSources::RubyDataSource} (which will be used if the tzinfo-data gem
-  # is available) supports Link zones. {DataSources::ZoneinfoDataSource}
-  # returns Link zones as if they were full Zones. If the {canonical_zone} or
-  # {canonical_identifier} methods are needed, the tzinfo-data gem should be
-  # installed.
-  #
-  # The {TZInfo::DataSource.get} method can be used to check which DataSource
-  # implementation is being used.
-  #
-  # @return [Timezone] the canonical {Timezone} instance for this {Timezone}.
-  def canonical_zone; end
-
-  # @return [TimezonePeriod] the current {TimezonePeriod} for the time zone.
-  def current_period; end
-
-  # Returns the current local time and {TimezonePeriod} for the time zone as
-  # an `Array`. The first element is the time as a {TimeWithOffset}. The
-  # second element is the period.
-  #
-  # @return [Array] an `Array` containing the current {TimeWithOffset} for the
-  #   time zone as the first element and the current {TimezonePeriod} for the
-  #   time zone as the second element.
-  def current_period_and_time; end
-
-  # Returns the current local time and {TimezonePeriod} for the time zone as
-  # an `Array`. The first element is the time as a {TimeWithOffset}. The
-  # second element is the period.
-  #
-  # @return [Array] an `Array` containing the current {TimeWithOffset} for the
-  #   time zone as the first element and the current {TimezonePeriod} for the
-  #   time zone as the second element.
-  def current_time_and_period; end
-
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [Boolean] whether daylight savings time is in effect at the given
-  #   time.
-  def dst?(time = T.unsafe(nil)); end
-
-  # @param tz [Object] an `Object` to compare this {Timezone} with.
-  # @return [Boolean] `true` if `tz` is an instance of {Timezone} and has the
-  #   same {identifier} as `self`, otherwise `false`.
-  def eql?(tz); end
-
-  # Returns {identifier}, modified to make it more readable. Set
-  # `skip_first_part` to omit the first part of the identifier (typically a
-  # region name) where there is more than one part.
-  #
-  # For example:
-  #
-  #     TZInfo::Timezone.get('Europe/Paris').friendly_identifier(false)         #=> "Europe - Paris"
-  #     TZInfo::Timezone.get('Europe/Paris').friendly_identifier(true)          #=> "Paris"
-  #     TZInfo::Timezone.get('America/Indiana/Knox').friendly_identifier(false) #=> "America - Knox, Indiana"
-  #     TZInfo::Timezone.get('America/Indiana/Knox').friendly_identifier(true)  #=> "Knox, Indiana"
-  #
-  # @param skip_first_part [Boolean] whether the first part of the identifier
-  #   (typically a region name) should be omitted.
-  # @return [String] the modified identifier.
-  def friendly_identifier(skip_first_part = T.unsafe(nil)); end
-
-  # @return [Integer] a hash based on the {identifier}.
-  def hash; end
-
-  # @return [String] the identifier of the time zone, for example,
-  #   `"Europe/Paris"`.
-  def identifier; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # Creates a `DateTime` object based on the given (Gregorian calendar) date
-  # and time parameters. The parameters are interpreted as a local time in the
-  # time zone. The result has the appropriate `offset` and
-  # {DateTimeWithOffset#timezone_offset timezone_offset}.
-  #
-  # _Warning:_ There are time values that are not valid as local times in a
-  # time zone (for example, during the transition from standard time to
-  # daylight savings time). There are also time values that are ambiguous,
-  # occurring more than once with different offsets to UTC (for example,
-  # during the transition from daylight savings time to standard time).
-  #
-  # In the first case (an invalid local time), a {PeriodNotFound} exception
-  # will be raised.
-  #
-  # In the second case (more than one occurrence), an {AmbiguousTime}
-  # exception will be raised unless the optional `dst` parameter or block
-  # handles the ambiguity.
-  #
-  # If the ambiguity is due to a transition from daylight savings time to
-  # standard time, the `dst` parameter can be used to select whether the
-  # daylight savings time or local time is used. For example, the following
-  # code would raise an {AmbiguousTime} exception:
-  #
-  #     tz = TZInfo::Timezone.get('America/New_York')
-  #     tz.local_datetime(2004,10,31,1,30,0,0)
-  #
-  # Specifying `dst = true` would return a `Time` with a UTC offset of -4
-  # hours and abbreviation EDT (Eastern Daylight Time). Specifying `dst =
-  # false` would return a `Time` with a UTC offset of -5 hours and
-  # abbreviation EST (Eastern Standard Time).
-  #
-  # The `dst` parameter will not be able to resolve an ambiguity resulting
-  # from the clocks being set back without changing from daylight savings time
-  # to standard time. In this case, if a block is specified, it will be called
-  # to resolve the ambiguity. The block must take a single parameter - an
-  # `Array` of {TimezonePeriod}s that need to be resolved. The block can
-  # select and return a single {TimezonePeriod} or return `nil` or an empty
-  # `Array` to cause an {AmbiguousTime} exception to be raised.
-  #
-  # The default value of the `dst` parameter can be specified using
-  # {Timezone.default_dst=}.
-  #
-  # values, interpreted as a local time in the time zone.
-  #
-  # @param hour [Integer] the hour (0-23).
-  # @param minute [Integer] the minute (0-59).
-  # @param second [Integer] the second (0-59).
-  # @param sub_second [Numeric] the fractional part of the second as either
-  #   a `Rational` that is greater than or equal to 0 and less than 1, or
-  #   the `Integer` 0.
-  # @param dst [Boolean] whether to resolve ambiguous local times by always
-  #   selecting the period observing daylight savings time (`true`), always
-  #   selecting the period observing standard time (`false`), or leaving the
-  #   ambiguity unresolved (`nil`).
-  # @param month [Integer] the month (1-12).
-  # @param day [Integer] the day of the month (1-31).
-  # @param year [Integer] the year.
-  # @raise [RangeError] if `sub_second` is a `Rational` but that is less
-  #   than 0 or greater than or equal to 1.
-  # @raise [PeriodNotFound] if the date and time parameters do not specify a
-  #   valid local time in the time zone.
-  # @raise [AmbiguousTime] if the date and time parameters are ambiguous for
-  #   the time zone and the `dst` parameter or block did not resolve the
-  #   ambiguity.
-  # @raise [RangeError] if `month` is not between 1 and 12.
-  # @raise [ArgumentError] if either of `year`, `month`, `day`, `hour`,
-  #   `minute`, or `second` is not an `Integer`.
-  # @raise [ArgumentError] if `sub_second` is not a `Rational`, or the
-  #   `Integer` 0.
-  # @raise [ArgumentError] if `utc_offset` is not `nil`, not an `Integer`
-  #   and not the `Symbol` `:utc`.
-  # @raise [RangeError] if `day` is not between 1 and 31.
-  # @raise [RangeError] if `hour` is not between 0 and 23.
-  # @raise [RangeError] if `minute` is not between 0 and 59.
-  # @raise [RangeError] if `second` is not between 0 and 59.
-  # @return [DateTimeWithOffset] a new `DateTime` object based on the given
-  # @yield [periods] if the `dst` parameter did not resolve an ambiguity, an
-  #   optional block is yielded to.
-  # @yieldparam periods [Array<TimezonePeriod>] an `Array` containing all
-  #   the {TimezonePeriod}s that still match `local_time` after applying the
-  #   `dst` parameter.
-  # @yieldreturn [Object] to resolve the ambiguity: a chosen {TimezonePeriod}
-  #   or an `Array` containing a chosen {TimezonePeriod}; to leave the
-  #   ambiguity unresolved: an empty `Array`, an `Array` containing more than
-  #   one {TimezonePeriod}, or `nil`.
-  def local_datetime(year, month = T.unsafe(nil), day = T.unsafe(nil), hour = T.unsafe(nil), minute = T.unsafe(nil), second = T.unsafe(nil), sub_second = T.unsafe(nil), dst = T.unsafe(nil), &block); end
-
-  # Creates a `Time` object based on the given (Gregorian calendar) date and
-  # time parameters. The parameters are interpreted as a local time in the
-  # time zone. The result has the appropriate `utc_offset`, `zone` and
-  # {TimeWithOffset#timezone_offset timezone_offset}.
-  #
-  # _Warning:_ There are time values that are not valid as local times in a
-  # time zone (for example, during the transition from standard time to
-  # daylight savings time). There are also time values that are ambiguous,
-  # occurring more than once with different offsets to UTC (for example,
-  # during the transition from daylight savings time to standard time).
-  #
-  # In the first case (an invalid local time), a {PeriodNotFound} exception
-  # will be raised.
-  #
-  # In the second case (more than one occurrence), an {AmbiguousTime}
-  # exception will be raised unless the optional `dst` parameter or block
-  # handles the ambiguity.
-  #
-  # If the ambiguity is due to a transition from daylight savings time to
-  # standard time, the `dst` parameter can be used to select whether the
-  # daylight savings time or local time is used. For example, the following
-  # code would raise an {AmbiguousTime} exception:
-  #
-  #     tz = TZInfo::Timezone.get('America/New_York')
-  #     tz.local_time(2004,10,31,1,30,0,0)
-  #
-  # Specifying `dst = true` would return a `Time` with a UTC offset of -4
-  # hours and abbreviation EDT (Eastern Daylight Time). Specifying `dst =
-  # false` would return a `Time` with a UTC offset of -5 hours and
-  # abbreviation EST (Eastern Standard Time).
-  #
-  # The `dst` parameter will not be able to resolve an ambiguity resulting
-  # from the clocks being set back without changing from daylight savings time
-  # to standard time. In this case, if a block is specified, it will be called
-  # to resolve the ambiguity. The block must take a single parameter - an
-  # `Array` of {TimezonePeriod}s that need to be resolved. The block can
-  # select and return a single {TimezonePeriod} or return `nil` or an empty
-  # `Array` to cause an {AmbiguousTime} exception to be raised.
-  #
-  # The default value of the `dst` parameter can be specified using
-  # {Timezone.default_dst=}.
-  #
-  # @param hour [Integer] the hour (0-23).
-  # @param minute [Integer] the minute (0-59).
-  # @param second [Integer] the second (0-59).
-  # @param sub_second [Numeric] the fractional part of the second as either
-  #   a `Rational` that is greater than or equal to 0 and less than 1, or
-  #   the `Integer` 0.
-  # @param dst [Boolean] whether to resolve ambiguous local times by always
-  #   selecting the period observing daylight savings time (`true`), always
-  #   selecting the period observing standard time (`false`), or leaving the
-  #   ambiguity unresolved (`nil`).
-  # @param month [Integer] the month (1-12).
-  # @param day [Integer] the day of the month (1-31).
-  # @param year [Integer] the year.
-  # @raise [RangeError] if `sub_second` is a `Rational` but that is less
-  #   than 0 or greater than or equal to 1.
-  # @raise [PeriodNotFound] if the date and time parameters do not specify a
-  #   valid local time in the time zone.
-  # @raise [AmbiguousTime] if the date and time parameters are ambiguous for
-  #   the time zone and the `dst` parameter or block did not resolve the
-  #   ambiguity.
-  # @raise [RangeError] if `month` is not between 1 and 12.
-  # @raise [ArgumentError] if either of `year`, `month`, `day`, `hour`,
-  #   `minute`, or `second` is not an `Integer`.
-  # @raise [ArgumentError] if `sub_second` is not a `Rational`, or the
-  #   `Integer` 0.
-  # @raise [ArgumentError] if `utc_offset` is not `nil`, not an `Integer`
-  #   and not the `Symbol` `:utc`.
-  # @raise [RangeError] if `day` is not between 1 and 31.
-  # @raise [RangeError] if `hour` is not between 0 and 23.
-  # @raise [RangeError] if `minute` is not between 0 and 59.
-  # @raise [RangeError] if `second` is not between 0 and 59.
-  # @return [TimeWithOffset] a new `Time` object based on the given values,
-  #   interpreted as a local time in the time zone.
-  # @yield [periods] if the `dst` parameter did not resolve an ambiguity, an
-  #   optional block is yielded to.
-  # @yieldparam periods [Array<TimezonePeriod>] an `Array` containing all
-  #   the {TimezonePeriod}s that still match `local_time` after applying the
-  #   `dst` parameter.
-  # @yieldreturn [Object] to resolve the ambiguity: a chosen {TimezonePeriod}
-  #   or an `Array` containing a chosen {TimezonePeriod}; to leave the
-  #   ambiguity unresolved: an empty `Array`, an `Array` containing more than
-  #   one {TimezonePeriod}, or `nil`.
-  def local_time(year, month = T.unsafe(nil), day = T.unsafe(nil), hour = T.unsafe(nil), minute = T.unsafe(nil), second = T.unsafe(nil), sub_second = T.unsafe(nil), dst = T.unsafe(nil), &block); end
-
-  # Creates a {Timestamp} object based on the given (Gregorian calendar) date
-  # and time parameters. The parameters are interpreted as a local time in the
-  # time zone. The result has the appropriate {Timestamp#utc_offset
-  # utc_offset} and {TimestampWithOffset#timezone_offset timezone_offset}.
-  #
-  # _Warning:_ There are time values that are not valid as local times in a
-  # time zone (for example, during the transition from standard time to
-  # daylight savings time). There are also time values that are ambiguous,
-  # occurring more than once with different offsets to UTC (for example,
-  # during the transition from daylight savings time to standard time).
-  #
-  # In the first case (an invalid local time), a {PeriodNotFound} exception
-  # will be raised.
-  #
-  # In the second case (more than one occurrence), an {AmbiguousTime}
-  # exception will be raised unless the optional `dst` parameter or block
-  # handles the ambiguity.
-  #
-  # If the ambiguity is due to a transition from daylight savings time to
-  # standard time, the `dst` parameter can be used to select whether the
-  # daylight savings time or local time is used. For example, the following
-  # code would raise an {AmbiguousTime} exception:
-  #
-  #     tz = TZInfo::Timezone.get('America/New_York')
-  #     tz.local_timestamp(2004,10,31,1,30,0,0)
-  #
-  # Specifying `dst = true` would return a `Time` with a UTC offset of -4
-  # hours and abbreviation EDT (Eastern Daylight Time). Specifying `dst =
-  # false` would return a `Time` with a UTC offset of -5 hours and
-  # abbreviation EST (Eastern Standard Time).
-  #
-  # The `dst` parameter will not be able to resolve an ambiguity resulting
-  # from the clocks being set back without changing from daylight savings time
-  # to standard time. In this case, if a block is specified, it will be called
-  # to resolve the ambiguity. The block must take a single parameter - an
-  # `Array` of {TimezonePeriod}s that need to be resolved. The block can
-  # select and return a single {TimezonePeriod} or return `nil` or an empty
-  # `Array` to cause an {AmbiguousTime} exception to be raised.
-  #
-  # The default value of the `dst` parameter can be specified using
-  # {Timezone.default_dst=}.
-  #
-  # @param hour [Integer] the hour (0-23).
-  # @param minute [Integer] the minute (0-59).
-  # @param second [Integer] the second (0-59).
-  # @param sub_second [Numeric] the fractional part of the second as either
-  #   a `Rational` that is greater than or equal to 0 and less than 1, or
-  #   the `Integer` 0.
-  # @param dst [Boolean] whether to resolve ambiguous local times by always
-  #   selecting the period observing daylight savings time (`true`), always
-  #   selecting the period observing standard time (`false`), or leaving the
-  #   ambiguity unresolved (`nil`).
-  # @param month [Integer] the month (1-12).
-  # @param day [Integer] the day of the month (1-31).
-  # @param year [Integer] the year.
-  # @raise [RangeError] if `sub_second` is a `Rational` but that is less
-  #   than 0 or greater than or equal to 1.
-  # @raise [PeriodNotFound] if the date and time parameters do not specify a
-  #   valid local time in the time zone.
-  # @raise [AmbiguousTime] if the date and time parameters are ambiguous for
-  #   the time zone and the `dst` parameter or block did not resolve the
-  #   ambiguity.
-  # @raise [RangeError] if `month` is not between 1 and 12.
-  # @raise [ArgumentError] if either of `year`, `month`, `day`, `hour`,
-  #   `minute`, or `second` is not an `Integer`.
-  # @raise [ArgumentError] if `sub_second` is not a `Rational`, or the
-  #   `Integer` 0.
-  # @raise [ArgumentError] if `utc_offset` is not `nil`, not an `Integer`
-  #   and not the `Symbol` `:utc`.
-  # @raise [RangeError] if `day` is not between 1 and 31.
-  # @raise [RangeError] if `hour` is not between 0 and 23.
-  # @raise [RangeError] if `minute` is not between 0 and 59.
-  # @raise [RangeError] if `second` is not between 0 and 59.
-  # @return [TimestampWithOffset] a new {Timestamp} object based on the given
-  #   values, interpreted as a local time in the time zone.
-  # @yield [periods] if the `dst` parameter did not resolve an ambiguity, an
-  #   optional block is yielded to.
-  # @yieldparam periods [Array<TimezonePeriod>] an `Array` containing all
-  #   the {TimezonePeriod}s that still match `local_time` after applying the
-  #   `dst` parameter.
-  # @yieldreturn [Object] to resolve the ambiguity: a chosen {TimezonePeriod}
-  #   or an `Array` containing a chosen {TimezonePeriod}; to leave the
-  #   ambiguity unresolved: an empty `Array`, an `Array` containing more than
-  #   one {TimezonePeriod}, or `nil`.
-  def local_timestamp(year, month = T.unsafe(nil), day = T.unsafe(nil), hour = T.unsafe(nil), minute = T.unsafe(nil), second = T.unsafe(nil), sub_second = T.unsafe(nil), dst = T.unsafe(nil), &block); end
-
-  # Converts a local time for the time zone to UTC.
-  #
-  # The result will either be a `Time`, `DateTime` or {Timestamp} according to
-  # the type of the `local_time` parameter.
-  #
-  # The UTC offset of the `local_time` parameter is ignored (it is treated as
-  # a time in the time zone represented by `self`).
-  #
-  # _Warning:_ There are local times that have no equivalent UTC times (for
-  # example, during the transition from standard time to daylight savings
-  # time). There are also local times that have more than one UTC equivalent
-  # (for example, during the transition from daylight savings time to standard
-  # time).
-  #
-  # In the first case (no equivalent UTC time), a {PeriodNotFound} exception
-  # will be raised.
-  #
-  # In the second case (more than one equivalent UTC time), an {AmbiguousTime}
-  # exception will be raised unless the optional `dst` parameter or block
-  # handles the ambiguity.
-  #
-  # If the ambiguity is due to a transition from daylight savings time to
-  # standard time, the `dst` parameter can be used to select whether the
-  # daylight savings time or local time is used. For example, the following
-  # code would raise an {AmbiguousTime} exception:
-  #
-  #     tz = TZInfo::Timezone.get('America/New_York')
-  #     tz.period_for_local(Time.new(2004,10,31,1,30,0))
-  #
-  # Specifying `dst = true` would select the daylight savings period from
-  # April to October 2004. Specifying `dst = false` would return the
-  # standard time period from October 2004 to April 2005.
-  #
-  # The `dst` parameter will not be able to resolve an ambiguity resulting
-  # from the clocks being set back without changing from daylight savings time
-  # to standard time. In this case, if a block is specified, it will be called
-  # to resolve the ambiguity. The block must take a single parameter - an
-  # `Array` of {TimezonePeriod}s that need to be resolved. The block can
-  # select and return a single {TimezonePeriod} or return `nil` or an empty
-  # `Array` to cause an {AmbiguousTime} exception to be raised.
-  #
-  # The default value of the `dst` parameter can be specified using
-  # {Timezone.default_dst=}.
-  #
-  # @param dst [Boolean] whether to resolve ambiguous local times by always
-  #   selecting the period observing daylight savings time (`true`), always
-  #   selecting the period observing standard time (`false`), or leaving the
-  #   ambiguity unresolved (`nil`).
-  # @param local_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [PeriodNotFound] if `local_time` is not valid for the time zone
-  #   (there is no equivalent UTC time).
-  # @raise [AmbiguousTime] if `local_time` was ambiguous for the time zone and
-  #   the `dst` parameter or block did not resolve the ambiguity.
-  # @raise [ArgumentError] if `local_time` is `nil`.
-  # @return [Object] the UTC equivalent of `local_time` as a `Time`,
-  #   `DateTime` or {Timestamp}.
-  # @yield [periods] if the `dst` parameter did not resolve an ambiguity, an
-  #   optional block is yielded to.
-  # @yieldparam periods [Array<TimezonePeriod>] an `Array` containing all
-  #   the {TimezonePeriod}s that still match `local_time` after applying the
-  #   `dst` parameter.
-  # @yieldreturn [Object] to resolve the ambiguity: a chosen {TimezonePeriod}
-  #   or an `Array` containing a chosen {TimezonePeriod}; to leave the
-  #   ambiguity unresolved: an empty `Array`, an `Array` containing more than
-  #   one {TimezonePeriod}, or `nil`.
-  def local_to_utc(local_time, dst = T.unsafe(nil)); end
-
-  # @return [String] the identifier of the time zone, for example,
-  #   `"Europe/Paris"`.
-  def name; end
-
-  # @return [TimeWithOffset] the current local time in the time zone.
-  def now; end
-
-  # Returns the observed offset from UTC in seconds at the given time. This
-  # includes adjustments made for daylight savings time.
-  #
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [Integer] the observed offset from UTC in seconds at the given
-  #   time.
-  def observed_utc_offset(time = T.unsafe(nil)); end
-
-  # Returns the unique offsets used by the time zone up to a given time (`to`)
-  # as an `Array` of {TimezoneOffset} instances.
-  #
-  # A from time may also be supplied using the `from` parameter. If from is
-  # not `nil`, only offsets used from that time onwards will be returned.
-  #
-  # Comparisons with `to` are exclusive. Comparisons with `from` are
-  # inclusive.
-  #
-  # @param to [Object] a `Time`, `DateTime` or {Timestamp} specifying the
-  #   latest (exclusive) offset to return.
-  # @param from [Object] an optional `Time`, `DateTime` or {Timestamp}
-  #   specifying the earliest (inclusive) offset to return.
-  # @raise [ArgumentError] if `from` is specified and `to` is not greater than
-  #   `from`.
-  # @raise [ArgumentError] is raised if `to` is `nil`.
-  # @raise [ArgumentError] if either `to` or `from` is a {Timestamp} with an
-  #   unspecified offset.
-  # @return [Array<TimezoneOffsets>] the offsets that are used earlier than
-  #   `to` and, if specified, at or later than `from`. Offsets may be returned
-  #   in any order.
-  def offsets_up_to(to, from = T.unsafe(nil)); end
-
-  # Returns the {TimezonePeriod} that is valid at a given time.
-  #
-  # Unlike {period_for_local} and {period_for_utc}, the UTC offset of the
-  # `time` parameter is taken into consideration.
-  #
-  # @param time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified
-  #   offset.
-  # @return [TimezonePeriod] the {TimezonePeriod} that is valid at `time`.
-  def period_for(time); end
-
-  # Returns the {TimezonePeriod} that is valid at the given local time.
-  #
-  # The UTC offset of the `local_time` parameter is ignored (it is treated as
-  # a time in the time zone represented by `self`). Use the {period_for}
-  # method instead if the the UTC offset of the time needs to be taken into
-  # consideration.
-  #
-  # _Warning:_ There are local times that have no equivalent UTC times (for
-  # example, during the transition from standard time to daylight savings
-  # time). There are also local times that have more than one UTC equivalent
-  # (for example, during the transition from daylight savings time to standard
-  # time).
-  #
-  # In the first case (no equivalent UTC time), a {PeriodNotFound} exception
-  # will be raised.
-  #
-  # In the second case (more than one equivalent UTC time), an {AmbiguousTime}
-  # exception will be raised unless the optional `dst` parameter or block
-  # handles the ambiguity.
-  #
-  # If the ambiguity is due to a transition from daylight savings time to
-  # standard time, the `dst` parameter can be used to select whether the
-  # daylight savings time or local time is used. For example, the following
-  # code would raise an {AmbiguousTime} exception:
-  #
-  #     tz = TZInfo::Timezone.get('America/New_York')
-  #     tz.period_for_local(Time.new(2004,10,31,1,30,0))
-  #
-  # Specifying `dst = true` would select the daylight savings period from
-  # April to October 2004. Specifying `dst = false` would return the
-  # standard time period from October 2004 to April 2005.
-  #
-  # The `dst` parameter will not be able to resolve an ambiguity resulting
-  # from the clocks being set back without changing from daylight savings time
-  # to standard time. In this case, if a block is specified, it will be called
-  # to resolve the ambiguity. The block must take a single parameter - an
-  # `Array` of {TimezonePeriod}s that need to be resolved. The block can
-  # select and return a single {TimezonePeriod} or return `nil` or an empty
-  # `Array` to cause an {AmbiguousTime} exception to be raised.
-  #
-  # The default value of the `dst` parameter can be specified using
-  # {Timezone.default_dst=}.
-  #
-  # @param dst [Boolean] whether to resolve ambiguous local times by always
-  #   selecting the period observing daylight savings time (`true`), always
-  #   selecting the period observing standard time (`false`), or leaving the
-  #   ambiguity unresolved (`nil`).
-  # @param local_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [PeriodNotFound] if `local_time` is not valid for the time zone
-  #   (there is no equivalent UTC time).
-  # @raise [AmbiguousTime] if `local_time` was ambiguous for the time zone and
-  #   the `dst` parameter or block did not resolve the ambiguity.
-  # @raise [ArgumentError] if `local_time` is `nil`.
-  # @return [TimezonePeriod] the {TimezonePeriod} that is valid at
-  #   `local_time`.
-  # @yield [periods] if the `dst` parameter did not resolve an ambiguity, an
-  #   optional block is yielded to.
-  # @yieldparam periods [Array<TimezonePeriod>] an `Array` containing all
-  #   the {TimezonePeriod}s that still match `local_time` after applying the
-  #   `dst` parameter.
-  # @yieldreturn [Object] to resolve the ambiguity: a chosen {TimezonePeriod}
-  #   or an `Array` containing a chosen {TimezonePeriod}; to leave the
-  #   ambiguity unresolved: an empty `Array`, an `Array` containing more than
-  #   one {TimezonePeriod}, or `nil`.
-  def period_for_local(local_time, dst = T.unsafe(nil)); end
-
-  # Returns the {TimezonePeriod} that is valid at a given time.
-  #
-  # The UTC offset of the `utc_time` parameter is ignored (it is treated as a
-  # UTC time). Use the {period_for} method instead if the UTC offset of the
-  # time needs to be taken into consideration.
-  #
-  # @param utc_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `utc_time` is `nil`.
-  # @return [TimezonePeriod] the {TimezonePeriod} that is valid at `utc_time`.
-  def period_for_utc(utc_time); end
-
-  # Returns the set of {TimezonePeriod}s that are valid for the given
-  # local time as an `Array`.
-  #
-  # The UTC offset of the `local_time` parameter is ignored (it is treated as
-  # a time in the time zone represented by `self`).
-  #
-  # This will typically return an `Array` containing a single
-  # {TimezonePeriod}. More than one {TimezonePeriod} will be returned when the
-  # local time is ambiguous (for example, when daylight savings time ends). An
-  # empty `Array` will be returned when the local time is not valid (for
-  # example, when daylight savings time begins).
-  #
-  # To obtain just a single {TimezonePeriod} in all cases, use
-  # {period_for_local} instead and specify how ambiguities should be resolved.
-  #
-  # @param local_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `local_time` is `nil`.
-  # @return [Array<TimezonePeriod>] the set of {TimezonePeriod}s that are
-  #   valid at `local_time`.
-  def periods_for_local(local_time); end
-
-  # Converts a time to local time for the time zone and returns a `String`
-  # representation of the local time according to the given format.
-  #
-  # `Timezone#strftime` first expands any occurrences of `%Z` in the format
-  # string to the time zone abbreviation for the local time (for example, EST
-  # or EDT). Depending on the type of `time` parameter, the result of the
-  # expansion is then passed to either `Time#strftime`, `DateTime#strftime` or
-  # `Timestamp#strftime` to handle any other format directives.
-  #
-  # This method is equivalent to the following:
-  #
-  #     time_zone.to_local(time).strftime(format)
-  #
-  # @param format [String] the format string.
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `format` or `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [String] the formatted local time.
-  def strftime(format, time = T.unsafe(nil)); end
-
-  # Converts a time to the local time for the time zone.
-  #
-  # The result will be of type {TimeWithOffset} (if passed a `Time`),
-  # {DateTimeWithOffset} (if passed a `DateTime`) or {TimestampWithOffset} (if
-  # passed a {Timestamp}). {TimeWithOffset}, {DateTimeWithOffset} and
-  # {TimestampWithOffset} are subclasses of `Time`, `DateTime` and {Timestamp}
-  # that provide additional information about the local result.
-  #
-  # Unlike {utc_to_local}, {to_local} takes the UTC offset of the given time
-  # into consideration.
-  #
-  # @param time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} that does not have a
-  #   specified UTC offset.
-  # @return [Object] the local equivalent of `time` as a {TimeWithOffset},
-  #   {DateTimeWithOffset} or {TimestampWithOffset}.
-  def to_local(time); end
-
-  # @return [String] {identifier}, modified to make it more readable.
-  def to_s; end
-
-  # Returns an `Array` of {TimezoneTransition} instances representing the
-  # times where the UTC offset of the timezone changes.
-  #
-  # Transitions are returned up to a given time (`to`).
-  #
-  # A from time may also be supplied using the `from` parameter. If from is
-  # not `nil`, only transitions from that time onwards will be returned.
-  #
-  # Comparisons with `to` are exclusive. Comparisons with `from` are
-  # inclusive. If a transition falls precisely on `to`, it will be excluded.
-  # If a transition falls on `from`, it will be included.
-  #
-  # @param to [Object] a `Time`, `DateTime` or {Timestamp} specifying the
-  #   latest (exclusive) transition to return.
-  # @param from [Object] an optional `Time`, `DateTime` or {Timestamp}
-  #   specifying the earliest (inclusive) transition to return.
-  # @raise [ArgumentError] if `from` is specified and `to` is not greater than
-  #   `from`.
-  # @raise [ArgumentError] is raised if `to` is `nil`.
-  # @raise [ArgumentError] if either `to` or `from` is a {Timestamp} with an
-  #   unspecified offset.
-  # @return [Array<TimezoneTransition>] the transitions that are earlier than
-  #   `to` and, if specified, at or later than `from`. Transitions are ordered
-  #   by when they occur, from earliest to latest.
-  def transitions_up_to(to, from = T.unsafe(nil)); end
-
-  # Returns the observed offset from UTC in seconds at the given time. This
-  # includes adjustments made for daylight savings time.
-  #
-  # @param time [Object] a `Time`, `DateTime` or `Timestamp`.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified UTC
-  #   offset.
-  # @return [Integer] the observed offset from UTC in seconds at the given
-  #   time.
-  def utc_offset(time = T.unsafe(nil)); end
-
-  # Converts a time in UTC to the local time for the time zone.
-  #
-  # The result will be of type {TimeWithOffset} (if passed a `Time`),
-  # {DateTimeWithOffset} (if passed a `DateTime`) or {TimestampWithOffset} (if
-  # passed a {Timestamp}). {TimeWithOffset}, {DateTimeWithOffset} and
-  # {TimestampWithOffset} are subclasses of `Time`, `DateTime` and {Timestamp}
-  # that provide additional information about the local result.
-  #
-  # The UTC offset of the `utc_time` parameter is ignored (it is treated as a
-  # UTC time). Use the {to_local} method instead if the the UTC offset of the
-  # time needs to be taken into consideration.
-  #
-  # @param utc_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `utc_time` is `nil`.
-  # @return [Object] the local equivalent of `utc_time` as a {TimeWithOffset},
-  #   {DateTimeWithOffset} or {TimestampWithOffset}.
-  def utc_to_local(utc_time); end
-
-  private
-
-  # Raises an {UnknownTimezone} exception.
-  #
-  # @raise [UnknownTimezone] always.
-  def raise_unknown_timezone; end
-
-  class << self
-    # Loads a {Timezone} from the serialized representation returned by {_dump}.
-    # This is method is called when using `Marshal.load` or `Marshal.restore`
-    # to restore a serialized {Timezone}.
-    #
-    # @param data [String] a serialized representation of a {Timezone}.
-    # @return [Timezone] the result of converting `data` back into a {Timezone}.
-    def _load(data); end
-
-    # Returns an `Array` of all the available time zones.
-    #
-    # {TimezoneProxy} instances are returned to avoid the overhead of loading
-    # time zone data until it is first needed.
-    #
-    # @return [Array<Timezone>] all available time zones.
-    def all; end
-
-    # Returns an `Array` of the identifiers of all the time zones that are
-    # observed by at least one {Country}. This is not the complete set of time
-    # zone identifiers as some are not country specific (e.g. `'Etc/GMT'`).
-    #
-    # {TimezoneProxy} instances are returned to avoid the overhead of loading
-    # time zone data until it is first needed.
-    #
-    # zones that are observed by at least one {Country}.
-    #
-    # @return [Array<String>] an `Array` of the identifiers of all the time
-    def all_country_zone_identifiers; end
-
-    # Returns an `Array` of all the time zones that are observed by at least
-    # one {Country}. This is not the complete set of time zones as some are
-    # not country specific (e.g. `'Etc/GMT'`).
-    #
-    # {TimezoneProxy} instances are returned to avoid the overhead of loading
-    # time zone data until it is first needed.
-    #
-    # @return [Array<Timezone>] an `Array` of all the time zones that are
-    #   observed by at least one {Country}.
-    def all_country_zones; end
-
-    # time zones that are defined by offsets and transitions.
-    #
-    # @return [Array<String>] an `Array` of the identifiers of all available
-    def all_data_zone_identifiers; end
-
-    # Returns an `Array` of all the available time zones that are
-    # defined by offsets and transitions.
-    #
-    # {TimezoneProxy} instances are returned to avoid the overhead of loading
-    # time zone data until it is first needed.
-    #
-    # @return [Array<Timezone>] an `Array` of all the available time zones
-    #   that are defined by offsets and transitions.
-    def all_data_zones; end
-
-    # @return [Array<String>] an `Array` containing the identifiers of all the
-    #   available time zones.
-    def all_identifiers; end
-
-    # time zones that are defined as links to / aliases for other time zones.
-    #
-    # @return [Array<String>] an `Array` of the identifiers of all available
-    def all_linked_zone_identifiers; end
-
-    # Returns an `Array` of all the available time zones that are
-    # defined as links to / aliases for other time zones.
-    #
-    # {TimezoneProxy} instances are returned to avoid the overhead of loading
-    # time zone data until it is first needed.
-    #
-    # @return [Array<Timezone>] an `Array` of all the available time zones
-    #   that are defined as links to / aliases for other time zones.
-    def all_linked_zones; end
-
-    # Returns the default value of the optional `dst` parameter of the
-    # {local_time}, {local_datetime} and {local_timestamp}, {local_to_utc}
-    # and {period_for_local} methods (`nil`, `true` or `false`).
-    #
-    # {default_dst} defaults to `nil` unless changed with {default_dst=}.
-    #
-    # @return [Boolean] the default value of the optional `dst` parameter of
-    #   the {local_time}, {local_datetime} and {local_timestamp},
-    #   {local_to_utc} and {period_for_local} methods (`nil`, `true` or
-    #   `false`).
-    def default_dst; end
-
-    # Sets the default value of the optional `dst` parameter of the
-    # {local_datetime}, {local_time}, {local_timestamp}, {local_to_utc} and
-    # {period_for_local} methods. Can be set to `nil`, `true` or `false`.
-    #
-    # @param value [Boolean] `nil`, `true` or `false`.
-    def default_dst=(value); end
-
-    # Returns a time zone by its IANA Time Zone Database identifier (e.g.
-    # `"Europe/London"` or `"America/Chicago"`). Call {all_identifiers} for a
-    # list of all the valid identifiers.
-    #
-    # The {get} method will return a subclass of {Timezone}, either a
-    # {DataTimezone} (for a time zone defined by rules that set out when
-    # transitions occur) or a {LinkedTimezone} (for a time zone that is just a
-    # link to or alias for a another time zone).
-    #
-    # @param identifier [String] an IANA Time Zone Database time zone
-    #   identifier.
-    # @raise [InvalidTimezoneIdentifier] if the `identifier` is not valid.
-    # @return [Timezone] the {Timezone} with the given `identifier`.
-    def get(identifier); end
-
-    # Returns a proxy for the time zone with the given identifier. This allows
-    # loading of the time zone data to be deferred until it is first needed.
-    #
-    # The identifier will not be validated. If an invalid identifier is
-    # specified, no exception will be raised until the proxy is used.
-    #
-    # @param identifier [String] an IANA Time Zone Database time zone
-    #   identifier.
-    # @return [TimezoneProxy] a proxy for the time zone with the given
-    #   `identifier`.
-    def get_proxy(identifier); end
-
-    private
-
-    # @return [DataSource] the current DataSource.
-    def data_source; end
-
-    # @param identifiers [Enumerable<String>] an `Enumerable` of time zone
-    #   identifiers.
-    # @return [Array<TimezoneProxy>] an `Array` of {TimezoneProxy}
-    #   instances corresponding to the given identifiers.
-    def get_proxies(identifiers); end
-  end
-end
-
-# Alias used by TZInfo::Data format1 releases.
-#
-# @private
-TZInfo::TimezoneDefinition = TZInfo::Format1::TimezoneDefinition
-
-# Alias used by TZInfo::Data format 1 releases.
-#
-# @private
-TZInfo::TimezoneIndexDefinition = TZInfo::Format1::TimezoneIndexDefinition
-
-# Represents an offset from UTC observed by a time zone.
-class TZInfo::TimezoneOffset
-  # Initializes a new {TimezoneOffset}.
-  #
-  # {TimezoneOffset} instances should not normally be constructed manually.
-  #
-  # The passed in `abbreviation` instance will be frozen.
-  #
-  # @param base_utc_offset [Integer] the base offset from UTC in seconds.
-  # @param std_offset [Integer] the offset from standard time in seconds.
-  # @param abbreviation [String] the abbreviation identifying the offset.
-  # @return [TimezoneOffset] a new instance of TimezoneOffset
-  def initialize(base_utc_offset, std_offset, abbreviation); end
-
-  # Determines if this {TimezoneOffset} is equal to another instance.
-  #
-  # @param toi [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `toi` is a {TimezoneOffset} with the same
-  #   {utc_offset}, {std_offset} and {abbreviation} as this {TimezoneOffset},
-  #   otherwise `false`.
-  def ==(toi); end
-
-  # The abbreviation that identifies this offset. For example GMT
-  # (Greenwich Mean Time) or BST (British Summer Time) for Europe/London.
-  #
-  # @return [String] the abbreviation that identifies this offset.
-  def abbr; end
-
-  # The abbreviation that identifies this offset. For example GMT
-  # (Greenwich Mean Time) or BST (British Summer Time) for Europe/London.
-  #
-  # @return [String] the abbreviation that identifies this offset.
-  def abbreviation; end
-
-  # Returns the base offset from UTC in seconds (`observed_utc_offset -
-  # std_offset`). This does not include any adjustment made for daylight
-  # savings time and will typically remain constant throughout the year.
-  #
-  # To obtain the currently observed offset from UTC, including the effect of
-  # daylight savings time, use {observed_utc_offset} instead.
-  #
-  # If you require accurate {base_utc_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of
-  # {base_utc_offset} has to be derived from changes to the observed UTC
-  # offset and DST status since it is not included in zoneinfo files.
-  #
-  # @return [Integer] the base offset from UTC in seconds.
-  def base_utc_offset; end
-
-  # Determines if daylight savings is in effect (i.e. if {std_offset} is
-  # non-zero).
-  #
-  # @return [Boolean] `true` if {std_offset} is non-zero, otherwise `false`.
-  def dst?; end
-
-  # Determines if this {TimezoneOffset} is equal to another instance.
-  #
-  # @param toi [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `toi` is a {TimezoneOffset} with the same
-  #   {utc_offset}, {std_offset} and {abbreviation} as this {TimezoneOffset},
-  #   otherwise `false`.
-  def eql?(toi); end
-
-  # @return [Integer] a hash based on {utc_offset}, {std_offset} and
-  #   {abbreviation}.
-  def hash; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # Returns the observed offset from UTC in seconds (`base_utc_offset +
-  # std_offset`). This includes adjustments made for daylight savings time.
-  #
-  # @return [Integer] the observed offset from UTC in seconds.
-  def observed_utc_offset; end
-
-  # Returns the offset from the time zone's standard time in seconds
-  # (`observed_utc_offset - base_utc_offset`). Zero when daylight savings time
-  # is not in effect. Non-zero (usually 3600 = 1 hour) if daylight savings is
-  # being observed.
-  #
-  # If you require accurate {std_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of {std_offset}
-  # has to be derived from changes to the observed UTC offset and DST status
-  # since it is not included in zoneinfo files.
-  #
-  # @return [Integer] the offset from the time zone's standard time in
-  #   seconds.
-  def std_offset; end
-
-  # Returns the base offset from UTC in seconds (`observed_utc_offset -
-  # std_offset`). This does not include any adjustment made for daylight
-  # savings time and will typically remain constant throughout the year.
-  #
-  # To obtain the currently observed offset from UTC, including the effect of
-  # daylight savings time, use {observed_utc_offset} instead.
-  #
-  # If you require accurate {base_utc_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of
-  # {base_utc_offset} has to be derived from changes to the observed UTC
-  # offset and DST status since it is not included in zoneinfo files.
-  #
-  # @return [Integer] the base offset from UTC in seconds.
-  def utc_offset; end
-
-  # Returns the observed offset from UTC in seconds (`base_utc_offset +
-  # std_offset`). This includes adjustments made for daylight savings time.
-  #
-  # @return [Integer] the observed offset from UTC in seconds.
-  def utc_total_offset; end
-end
-
-# {TimezonePeriod} represents a period of time for a time zone where the same
-# offset from UTC applies. It provides access to the observed offset, time
-# zone abbreviation, start time and end time.
-#
-# The period of time can be unbounded at the start, end, or both the start
-# and end.
-#
-# @abstract Time zone period data will returned as an instance of one of the
-#   subclasses of {TimezonePeriod}.
-class TZInfo::TimezonePeriod
-  # Initializes a {TimezonePeriod}.
-  #
-  # @param offset [TimezoneOffset] the offset that is observed for the period
-  #   of time.
-  # @raise [ArgumentError] if `offset` is `nil`.
-  # @return [TimezonePeriod] a new instance of TimezonePeriod
-  def initialize(offset); end
-
-  # The abbreviation that identifies this offset. For example GMT
-  # (Greenwich Mean Time) or BST (British Summer Time) for Europe/London.
-  #
-  # @return [String] the abbreviation that identifies this offset.
-  def abbr; end
-
-  # The abbreviation that identifies this offset. For example GMT
-  # (Greenwich Mean Time) or BST (British Summer Time) for Europe/London.
-  #
-  # @return [String] the abbreviation that identifies this offset.
-  def abbreviation; end
-
-  # Returns the base offset from UTC in seconds (`observed_utc_offset -
-  # std_offset`). This does not include any adjustment made for daylight
-  # savings time and will typically remain constant throughout the year.
-  #
-  # To obtain the currently observed offset from UTC, including the effect of
-  # daylight savings time, use {observed_utc_offset} instead.
-  #
-  # If you require accurate {base_utc_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of
-  # {base_utc_offset} has to be derived from changes to the observed UTC
-  # offset and DST status since it is not included in zoneinfo files.
-  #
-  # @return [Integer] the base offset from UTC in seconds.
-  def base_utc_offset; end
-
-  # Determines if daylight savings is in effect (i.e. if {std_offset} is
-  # non-zero).
-  #
-  # @return [Boolean] `true` if {std_offset} is non-zero, otherwise `false`.
-  def dst?; end
-
-  # @return [TimezoneTransition] the transition that defines the end of this
-  #   {TimezonePeriod} (`nil` if the end is unbounded).
-  def end_transition; end
-
-  # Returns the UTC end time of the period or `nil` if the end of the period
-  # is unbounded.
-  #
-  # The result is returned as a {Timestamp}. To obtain the end time as a
-  # `Time` or `DateTime`, call either {Timestamp#to_time to_time} or
-  # {Timestamp#to_datetime to_datetime} on the result.
-  #
-  # @return [Timestamp] the UTC end time of the period or `nil` if the end of
-  #   the period is unbounded.
-  def ends_at; end
-
-  # Returns the local end time of the period or `nil` if the end of the period
-  # is unbounded.
-  #
-  # The result is returned as a {TimestampWithOffset}. To obtain the end time
-  # as a `Time` or `DateTime`, call either {TimestampWithOffset#to_time
-  # to_time} or {TimestampWithOffset#to_datetime to_datetime} on the result.
-  #
-  # @return [TimestampWithOffset] the local end time of the period or `nil` if
-  #   the end of the period is unbounded.
-  def local_ends_at; end
-
-  # Returns the local start time of the period or `nil` if the start of the
-  # period is unbounded.
-  #
-  # The result is returned as a {TimestampWithOffset}. To obtain the start
-  # time as a `Time` or `DateTime`, call either {TimestampWithOffset#to_time
-  # to_time} or {TimestampWithOffset#to_datetime to_datetime} on the result.
-  #
-  # @return [TimestampWithOffset] the local start time of the period or `nil`
-  #   if the start of the period is unbounded.
-  def local_starts_at; end
-
-  # Returns the observed offset from UTC in seconds (`base_utc_offset +
-  # std_offset`). This includes adjustments made for daylight savings time.
-  #
-  # @return [Integer] the observed offset from UTC in seconds.
-  def observed_utc_offset; end
-
-  # @return [TimezoneOffset] the offset that applies in the period of time.
-  def offset; end
-
-  # @return [TimezoneTransition] the transition that defines the start of this
-  #   {TimezonePeriod} (`nil` if the start is unbounded).
-  def start_transition; end
-
-  # Returns the UTC start time of the period or `nil` if the start of the
-  # period is unbounded.
-  #
-  # The result is returned as a {Timestamp}. To obtain the start time as a
-  # `Time` or `DateTime`, call either {Timestamp#to_time to_time} or
-  # {Timestamp#to_datetime to_datetime} on the result.
-  #
-  # @return [Timestamp] the UTC start time of the period or `nil` if the start
-  #   of the period is unbounded.
-  def starts_at; end
-
-  # Returns the offset from the time zone's standard time in seconds
-  # (`observed_utc_offset - base_utc_offset`). Zero when daylight savings time
-  # is not in effect. Non-zero (usually 3600 = 1 hour) if daylight savings is
-  # being observed.
-  #
-  # If you require accurate {std_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of {std_offset}
-  # has to be derived from changes to the observed UTC offset and DST status
-  # since it is not included in zoneinfo files.
-  #
-  # @return [Integer] the offset from the time zone's standard time in
-  #   seconds.
-  def std_offset; end
-
-  # Returns the base offset from UTC in seconds (`observed_utc_offset -
-  # std_offset`). This does not include any adjustment made for daylight
-  # savings time and will typically remain constant throughout the year.
-  #
-  # To obtain the currently observed offset from UTC, including the effect of
-  # daylight savings time, use {observed_utc_offset} instead.
-  #
-  # If you require accurate {base_utc_offset} values, you should install the
-  # tzinfo-data gem and set {DataSources::RubyDataSource} as the {DataSource}.
-  # When using {DataSources::ZoneinfoDataSource}, the value of
-  # {base_utc_offset} has to be derived from changes to the observed UTC
-  # offset and DST status since it is not included in zoneinfo files.
-  #
-  # @return [Integer] the base offset from UTC in seconds.
-  def utc_offset; end
-
-  # Returns the observed offset from UTC in seconds (`base_utc_offset +
-  # std_offset`). This includes adjustments made for daylight savings time.
-  #
-  # @return [Integer] the observed offset from UTC in seconds.
-  def utc_total_offset; end
-
-  # The abbreviation that identifies this offset. For example GMT
-  # (Greenwich Mean Time) or BST (British Summer Time) for Europe/London.
-  #
-  # @return [String] the abbreviation that identifies this offset.
-  def zone_identifier; end
-
-  private
-
-  # Raises a {NotImplementedError} to indicate that subclasses should override
-  # a method.
-  #
-  # @raise [NotImplementedError] always.
-  def raise_not_implemented(method_name); end
-
-  # @param transition [TimezoneTransition] a transition or `nil`.
-  # @return [Timestamp] the {Timestamp} representing when a transition occurs,
-  #   or `nil` if `transition` is `nil`.
-  def timestamp(transition); end
-
-  # @param transition [TimezoneTransition] a transition or `nil`.
-  # @return [TimestampWithOffset] a {Timestamp} representing when a transition
-  #   occurs with offset set to {#offset}, or `nil` if `transition` is `nil`.
-  def timestamp_with_offset(transition); end
-end
-
-# A proxy class standing in for a {Timezone} with a given identifier.
-# {TimezoneProxy} inherits from {Timezone} and can be treated identically to
-# {Timezone} instances loaded with {Timezone.get}.
-#
-# {TimezoneProxy} instances are used to avoid the performance overhead of
-# loading time zone data into memory, for example, by {Timezone.all}.
-#
-# The first time an attempt is made to access the data for the time zone, the
-# real {Timezone} will be loaded is loaded. If the proxy's identifier was not
-# valid, then an exception will be raised at this point.
-class TZInfo::TimezoneProxy < ::TZInfo::Timezone
-  # Initializes a new {TimezoneProxy}.
-  #
-  # The `identifier` parameter is not checked when initializing the proxy. It
-  # will be validated when the real {Timezone} instance is loaded.
-  #
-  # @param identifier [String] an IANA Time Zone Database time zone
-  #   identifier.
-  # @return [TimezoneProxy] a new instance of TimezoneProxy
-  def initialize(identifier); end
-
-  # Returns a serialized representation of this {TimezoneProxy}. This method
-  # is called when using `Marshal.dump` with an instance of {TimezoneProxy}.
-  #
-  # @param limit [Integer] the maximum depth to dump - ignored. @return
-  #   [String] a serialized representation of this {TimezoneProxy}.
-  # @return [String] a serialized representation of this {TimezoneProxy}.
-  def _dump(limit); end
-
-  # Returns the canonical {Timezone} instance for this {Timezone}.
-  #
-  # The IANA Time Zone database contains two types of definition: Zones and
-  # Links. Zones are defined by rules that set out when transitions occur.
-  # Links are just references to fully defined Zone, creating an alias for
-  # that Zone.
-  #
-  # Links are commonly used where a time zone has been renamed in a release of
-  # the Time Zone database. For example, the US/Eastern Zone was renamed as
-  # America/New_York. A US/Eastern Link was added in its place, linking to
-  # (and creating an alias for) America/New_York.
-  #
-  # Links are also used for time zones that are currently identical to a full
-  # Zone, but that are administered separately. For example, Europe/Vatican is
-  # a Link to (and alias for) Europe/Rome.
-  #
-  # For a full Zone (implemented by {DataTimezone}), {canonical_zone} returns
-  # self.
-  #
-  # For a Link (implemented by {LinkedTimezone}), {canonical_zone} returns a
-  # {Timezone} instance representing the full Zone that the link targets.
-  #
-  # TZInfo can be used with different data sources (see the documentation for
-  # {TZInfo::DataSource}). Some DataSource implementations may not support
-  # distinguishing between full Zones and Links and will treat all time zones
-  # as full Zones. In this case, {canonical_zone} will always return `self`.
-  #
-  # There are two built-in DataSource implementations.
-  # {DataSources::RubyDataSource} (which will be used if the tzinfo-data gem
-  # is available) supports Link zones. {DataSources::ZoneinfoDataSource}
-  # returns Link zones as if they were full Zones. If the {canonical_zone} or
-  # {canonical_identifier} methods are needed, the tzinfo-data gem should be
-  # installed.
-  #
-  # The {TZInfo::DataSource.get} method can be used to check which DataSource
-  # implementation is being used.
-  #
-  # @return [Timezone] the canonical {Timezone} instance for this {Timezone}.
-  def canonical_zone; end
-
-  # @return [String] the identifier of the time zone, for example,
-  #   `"Europe/Paris"`.
-  def identifier; end
-
-  # Returns the {TimezonePeriod} that is valid at a given time.
-  #
-  # Unlike {period_for_local} and {period_for_utc}, the UTC offset of the
-  # `time` parameter is taken into consideration.
-  #
-  # @param time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `time` is `nil`.
-  # @raise [ArgumentError] if `time` is a {Timestamp} with an unspecified
-  #   offset.
-  # @return [TimezonePeriod] the {TimezonePeriod} that is valid at `time`.
-  def period_for(time); end
-
-  # Returns the set of {TimezonePeriod}s that are valid for the given
-  # local time as an `Array`.
-  #
-  # The UTC offset of the `local_time` parameter is ignored (it is treated as
-  # a time in the time zone represented by `self`).
-  #
-  # This will typically return an `Array` containing a single
-  # {TimezonePeriod}. More than one {TimezonePeriod} will be returned when the
-  # local time is ambiguous (for example, when daylight savings time ends). An
-  # empty `Array` will be returned when the local time is not valid (for
-  # example, when daylight savings time begins).
-  #
-  # To obtain just a single {TimezonePeriod} in all cases, use
-  # {period_for_local} instead and specify how ambiguities should be resolved.
-  #
-  # @param local_time [Object] a `Time`, `DateTime` or {Timestamp}.
-  # @raise [ArgumentError] if `local_time` is `nil`.
-  # @return [Array<TimezonePeriod>] the set of {TimezonePeriod}s that are
-  #   valid at `local_time`.
-  def periods_for_local(local_time); end
-
-  # Returns an `Array` of {TimezoneTransition} instances representing the
-  # times where the UTC offset of the timezone changes.
-  #
-  # Transitions are returned up to a given time (`to`).
-  #
-  # A from time may also be supplied using the `from` parameter. If from is
-  # not `nil`, only transitions from that time onwards will be returned.
-  #
-  # Comparisons with `to` are exclusive. Comparisons with `from` are
-  # inclusive. If a transition falls precisely on `to`, it will be excluded.
-  # If a transition falls on `from`, it will be included.
-  #
-  # @param to [Object] a `Time`, `DateTime` or {Timestamp} specifying the
-  #   latest (exclusive) transition to return.
-  # @param from [Object] an optional `Time`, `DateTime` or {Timestamp}
-  #   specifying the earliest (inclusive) transition to return.
-  # @raise [ArgumentError] if `from` is specified and `to` is not greater than
-  #   `from`.
-  # @raise [ArgumentError] is raised if `to` is `nil`.
-  # @raise [ArgumentError] if either `to` or `from` is a {Timestamp} with an
-  #   unspecified offset.
-  # @return [Array<TimezoneTransition>] the transitions that are earlier than
-  #   `to` and, if specified, at or later than `from`. Transitions are ordered
-  #   by when they occur, from earliest to latest.
-  def transitions_up_to(to, from = T.unsafe(nil)); end
-
-  private
-
-  # Returns the real {Timezone} instance being proxied.
-  #
-  # The real {Timezone} is loaded using {Timezone.get} on the first access.
-  #
-  # @return [Timezone] the real {Timezone} instance being proxied.
-  def real_timezone; end
-
-  class << self
-    # Loads a {TimezoneProxy} from the serialized representation returned by
-    # {_dump}. This is method is called when using `Marshal.load` or
-    # `Marshal.restore` to restore a serialized {Timezone}.
-    #
-    # @param data [String] a serialized representation of a {TimezoneProxy}.
-    # @return [TimezoneProxy] the result of converting `data` back into a
-    #   {TimezoneProxy}.
-    def _load(data); end
-  end
-end
-
-# Represents a transition from one observed UTC offset ({TimezoneOffset} to
-# another for a time zone.
-class TZInfo::TimezoneTransition
-  # Initializes a new {TimezoneTransition}.
-  #
-  # {TimezoneTransition} instances should not normally be constructed
-  # manually.
-  #
-  # @param offset [TimezoneOffset] the offset the transition changes to.
-  # @param previous_offset [TimezoneOffset] the offset the transition changes
-  #   from.
-  # @param timestamp_value [Integer] when the transition occurs as a
-  #   number of seconds since 1970-01-01 00:00:00 UTC ignoring leap seconds
-  #   (i.e. each day is treated as if it were 86,400 seconds long).
-  # @return [TimezoneTransition] a new instance of TimezoneTransition
-  def initialize(offset, previous_offset, timestamp_value); end
-
-  # Determines if this {TimezoneTransition} is equal to another instance.
-  #
-  # @param tti [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `tti` is a {TimezoneTransition} with the same
-  #   {offset}, {previous_offset} and {timestamp_value} as this
-  #   {TimezoneTransition}, otherwise `false`.
-  def ==(tti); end
-
-  # Returns a {Timestamp} instance representing the UTC time when this
-  # transition occurs.
-  #
-  # To obtain the result as a `Time` or `DateTime`, call either
-  # {Timestamp#to_time to_time} or {Timestamp#to_datetime to_datetime} on the
-  # {Timestamp} instance that is returned.
-  #
-  # @return [Timestamp] the UTC time when this transition occurs.
-  def at; end
-
-  # Determines if this {TimezoneTransition} is equal to another instance.
-  #
-  # @param tti [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `tti` is a {TimezoneTransition} with the same
-  #   {offset}, {previous_offset} and {timestamp_value} as this
-  #   {TimezoneTransition}, otherwise `false`.
-  def eql?(tti); end
-
-  # @return [Integer] a hash based on {offset}, {previous_offset} and
-  #   {timestamp_value}.
-  def hash; end
-
-  # Returns a {TimestampWithOffset} instance representing the local time when
-  # this transition causes the previous observance to end (calculated from
-  # {at} using {previous_offset}).
-  #
-  # To obtain the result as a `Time` or `DateTime`, call either
-  # {TimestampWithOffset#to_time to_time} or {TimestampWithOffset#to_datetime
-  # to_datetime} on the {TimestampWithOffset} instance that is returned.
-  #
-  # @return [TimestampWithOffset] the local time when this transition causes
-  #   the previous observance to end.
-  def local_end_at; end
-
-  # Returns a {TimestampWithOffset} instance representing the local time when
-  # this transition causes the next observance to start (calculated from {at}
-  # using {offset}).
-  #
-  # To obtain the result as a `Time` or `DateTime`, call either
-  # {TimestampWithOffset#to_time to_time} or {TimestampWithOffset#to_datetime
-  # to_datetime} on the {TimestampWithOffset} instance that is returned.
-  #
-  # @return [TimestampWithOffset] the local time when this transition causes
-  #   the next observance to start.
-  def local_start_at; end
-
-  # @return [TimezoneOffset] the offset this transition changes to.
-  def offset; end
-
-  # @return [TimezoneOffset] the offset this transition changes from.
-  def previous_offset; end
-
-  # When this transition occurs as an `Integer` number of seconds since
-  # 1970-01-01 00:00:00 UTC ignoring leap seconds (i.e. each day is treated as
-  # if it were 86,400 seconds long). Equivalent to the result of calling the
-  # {Timestamp#value value} method on the {Timestamp} returned by {at}.
-  #
-  # @return [Integer] when this transition occurs as a number of seconds since
-  #   1970-01-01 00:00:00 UTC ignoring leap seconds.
-  def timestamp_value; end
-end
-
-# Base class for rules definining the transition between standard and daylight
-# savings time.
-#
-# @abstract
-# @private
-class TZInfo::TransitionRule
-  # Initializes a new {TransitionRule}.
-  #
-  # @param transition_at [Integer] the time in seconds after midnight local
-  #   time at which the transition occurs.
-  # @raise [ArgumentError] if `transition_at` is not an `Integer`.
-  # @return [TransitionRule] a new instance of TransitionRule
-  def initialize(transition_at); end
-
-  # Determines if this {TransitionRule} is equal to another instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {TransitionRule} with the same
-  #   {transition_at} as this {TransitionRule}, otherwise `false`.
-  def ==(r); end
-
-  # Calculates the time of the transition from a given offset on a given year.
-  #
-  # @param offset [TimezoneOffset] the current offset at the time the rule
-  #   will transition.
-  # @param year [Integer] the year in which the transition occurs (local
-  #   time).
-  # @return [TimestampWithOffset] the time at which the transition occurs.
-  def at(offset, year); end
-
-  # Determines if this {TransitionRule} is equal to another instance.
-  #
-  # @param r [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `r` is a {TransitionRule} with the same
-  #   {transition_at} as this {TransitionRule}, otherwise `false`.
-  def eql?(r); end
-
-  # @return [Integer] a hash based on {hash_args} (defaulting to
-  #   {transition_at}).
-  def hash; end
-
-  # Returns the number of seconds after midnight local time on the day
-  # identified by the rule at which the transition occurs. Can be negative to
-  # denote a time on the prior day. Can be greater than or equal to 86,400 to
-  # denote a time of the following day.
-  #
-  # @return [Integer] the time in seconds after midnight local time at which
-  #   the transition occurs.
-  def transition_at; end
-
-  protected
-
-  # @return [Array] an `Array` of parameters that will influence the output of
-  #   {hash}.
-  def hash_args; end
-end
-
-# Represents a period of time in a time zone where the same offset from UTC
-# applies. The period of time is bounded at at least one end, either having a
-# start transition, end transition or both start and end transitions.
-class TZInfo::TransitionsTimezonePeriod < ::TZInfo::TimezonePeriod
-  # Initializes a {TransitionsTimezonePeriod}.
-  #
-  # At least one of `start_transition` and `end_transition` must be specified.
-  #
-  # @param start_transition [TimezoneTransition] the transition that defines
-  #   the start of the period, or `nil` if the start is unbounded.
-  # @param end_transition [TimezoneTransition] the transition that defines the
-  #   end of the period, or `nil` if the end is unbounded.
-  # @raise [ArgumentError] if both `start_transition` and `end_transition` are
-  #   `nil`.
-  # @return [TransitionsTimezonePeriod] a new instance of TransitionsTimezonePeriod
-  def initialize(start_transition, end_transition); end
-
-  # Determines if this {TransitionsTimezonePeriod} is equal to another
-  # instance.
-  #
-  # @param p [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `p` is a {TransitionsTimezonePeriod} with the
-  #   same {offset}, {start_transition} and {end_transition}, otherwise
-  #   `false`.
-  def ==(p); end
-
-  # @return [TimezoneTransition] the transition that defines the end of this
-  #   {TimezonePeriod} (`nil` if the end is unbounded).
-  def end_transition; end
-
-  # Determines if this {TransitionsTimezonePeriod} is equal to another
-  # instance.
-  #
-  # @param p [Object] the instance to test for equality.
-  # @return [Boolean] `true` if `p` is a {TransitionsTimezonePeriod} with the
-  #   same {offset}, {start_transition} and {end_transition}, otherwise
-  #   `false`.
-  def eql?(p); end
-
-  # @return [Integer] a hash based on {start_transition} and {end_transition}.
-  def hash; end
-
-  # @return [String] the internal object state as a programmer-readable
-  #   `String`.
-  def inspect; end
-
-  # @return [TimezoneTransition] the transition that defines the start of this
-  #   {TimezonePeriod} (`nil` if the start is unbounded).
-  def start_transition; end
-end
-
-# An implementation of {StringDeduper} using the `String#-@` method where
-# that method performs deduplication (Ruby 2.5 and later).
-#
-# Note that this is slightly different to the plain {StringDeduper}
-# implementation. In this implementation, frozen literal strings are already
-# in the pool and are candidates for being returned, even when passed
-# another equal frozen non-literal string. {StringDeduper} will always
-# return frozen strings.
-#
-# There are also differences in encoding handling. This implementation will
-# treat strings with different encodings as different strings.
-# {StringDeduper} will treat strings with the compatible encodings as the
-# same string.
-#
-# @private
-class TZInfo::UnaryMinusGlobalStringDeduper
-  # @param string [String] the string to deduplicate.
-  # @return [bool] `string` if it is frozen, otherwise a frozen, possibly
-  #   pre-existing copy of `string`.
-  def dedupe(string); end
-end
-
-# {UnknownTimezone} is raised when calling methods on an instance of
-# {Timezone} that was created directly. To obtain {Timezone} instances the
-# {Timezone.get} method should be used instead.
-class TZInfo::UnknownTimezone < ::StandardError; end
-
-# Object#untaint is deprecated in Ruby >= 2.7 and will be removed in 3.2.
-# UntaintExt adds a refinement to make Object#untaint a no-op and avoid the
-# warning.
-#
-# @private
-module TZInfo::UntaintExt; end
-
-# The TZInfo version number.
-TZInfo::VERSION = T.let(T.unsafe(nil), String)
-
-# The {WithOffset} module is included in {TimeWithOffset},
-# {DateTimeWithOffset} and {TimestampWithOffset}. It provides an override for
-# the {strftime} method that handles expanding the `%Z` directive according to
-# the {TimezoneOffset#abbreviation abbreviation} of the {TimezoneOffset}
-# associated with a local time.
-module TZInfo::WithOffset
-  # Overrides the `Time`, `DateTime` or {Timestamp} version of `strftime`,
-  # replacing `%Z` with the {TimezoneOffset#abbreviation abbreviation} of the
-  # associated {TimezoneOffset}. If there is no associated offset, `%Z` is
-  # expanded by the base class instead.
-  #
-  # All the format directives handled by the base class are supported.
-  #
-  # @param format [String] the format string.
-  # @raise [ArgumentError] if `format` is `nil`.
-  # @return [String] the formatted time.
-  def strftime(format); end
-
-  protected
-
-  # Performs a calculation if there is an associated {TimezoneOffset}.
-  #
-  # @param result [Object] a result value that can be manipulated by the block
-  #   if there is an associated {TimezoneOffset}.
-  # @private
-  # @return [Object] the result of the block if there is an associated
-  #   {TimezoneOffset}, otherwise the `result` parameter.
-  # @yield [period, result] if there is an associated {TimezoneOffset}, the
-  #   block is yielded to in order to calculate the method result.
-  # @yieldparam period [TimezoneOffset] the associated {TimezoneOffset}.
-  # @yieldparam result [Object] the `result` parameter.
-  # @yieldreturn [Object] the result of the calculation performed if there is
-  #   an associated {TimezoneOffset}.
-  def if_timezone_offset(result = T.unsafe(nil)); end
-end