Class TZInfo::Country
In: lib/tzinfo/country.rb
Parent: Object

An ISO 3166 country. Can be used to get a list of Timezones for a country. For example: 

 us = Country.get('US')
 us.zone_identifiers
 us.zones
 us.zone_info

Methods

<=>   _dump   _load   all   all_codes   code   eql?   get   hash   inspect   name   new   to_s   zone_identifiers   zone_info   zone_names   zones  

Included Modules

Comparable

Public Class methods

_load(data)

Loads a marshalled Country.

[Source]

# File lib/tzinfo/country.rb, line 157
    def self._load(data)
      Country.get(data)
    end
all()

Returns an Array of all the defined Countries.

[Source]

# File lib/tzinfo/country.rb, line 79
    def self.all
      load_index
      Indexes::Countries.countries.keys.collect {|code| get(code)}
    end
all_codes()

Returns an Array of all the valid country codes.

[Source]

# File lib/tzinfo/country.rb, line 73
    def self.all_codes
      load_index
      Indexes::Countries.countries.keys
    end
get(identifier)

Gets a Country by its ISO 3166 code. Raises an InvalidCountryCode exception if it couldn‘t be found.

[Source]

# File lib/tzinfo/country.rb, line 46
    def self.get(identifier)
      instance = @@countries[identifier]
      
      unless instance
        load_index
        info = Indexes::Countries.countries[identifier]        
        raise InvalidCountryCode.new, 'Invalid identifier' unless info
        instance = Country.new(info)
        @@countries[identifier] = instance
      end      
      
      instance        
    end
new(identifier)

If identifier is a CountryInfo object, initializes the Country instance, otherwise calls get(identifier).

[Source]

# File lib/tzinfo/country.rb, line 62
    def self.new(identifier)      
      if identifier.kind_of?(CountryInfo)
        instance = super()
        instance.send :setup, identifier
        instance
      else
        get(identifier)
      end
    end

Public Instance methods

<=>(c)

Compare two Countries based on their code. Returns -1 if c is less than self, 0 if c is equal to self and +1 if c is greater than self.

[Source]

# File lib/tzinfo/country.rb, line 136
    def <=>(c)
      code <=> c.code
    end
_dump(limit)

Dumps this Country for marshalling.

[Source]

# File lib/tzinfo/country.rb, line 152
    def _dump(limit)
      code
    end
code()

The ISO 3166 country code.

[Source]

# File lib/tzinfo/country.rb, line 85
    def code
      @info.code
    end
eql?(c)

Returns true if and only if the code of c is equal to the code of this Country.

[Source]

# File lib/tzinfo/country.rb, line 142
    def eql?(c)
      self == c
    end
hash()

Returns a hash value for this Country.

[Source]

# File lib/tzinfo/country.rb, line 147
    def hash
      code.hash
    end
inspect()

Returns internal object state as a programmer-readable string.

[Source]

# File lib/tzinfo/country.rb, line 100
    def inspect
      "#<#{self.class}: #{@info.code}>"
    end
name()

The name of the country.

[Source]

# File lib/tzinfo/country.rb, line 90
    def name
      @info.name
    end
to_s()

Alias for name.

[Source]

# File lib/tzinfo/country.rb, line 95
    def to_s
      name
    end
zone_identifiers()

Returns a frozen array of all the zone identifiers for 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).

[Source]

# File lib/tzinfo/country.rb, line 108
    def zone_identifiers
      @info.zone_identifiers
    end
zone_info()

Returns a frozen array of all the timezones for the for the country as CountryTimezone instances (containing extra information about each zone). 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).

[Source]

# File lib/tzinfo/country.rb, line 130
    def zone_info
      @info.zones
    end
zone_names()

Alias for zone_identifiers

zones()

An array of all the Timezones for this country. Returns TimezoneProxy objects to avoid the overhead of loading Timezone definitions until a conversion is actually required. The Timezones are returned in an order that 

  (1) makes some geographical sense, and
  (2) puts the most populous zones first, where that does not contradict (1).

[Source]

# File lib/tzinfo/country.rb, line 119
    def zones
      zone_identifiers.collect {|id|
        Timezone.get_proxy(id)        
      }
    end

[Validate]