Class: TZInfo::Country

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/tzinfo/country.rb

Overview

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

Constant Summary collapse

@@countries =

Defined countries.

{}
@@index_loaded =

Whether the countries index has been loaded yet.

false

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

._load(data) ⇒ Object

Loads a marshalled Country.



160
161
162
 
# File 'lib/tzinfo/country.rb', line 160

def self._load(data)
  Country.get(data)
end

.all ⇒ Object

Returns an Array of all the defined Countries.



82
83
84
85
 
# File 'lib/tzinfo/country.rb', line 82

def self.all
  load_index
  Indexes::Countries.countries.keys.collect {|code| get(code)}
end

.all_codes ⇒ Object

Returns an Array of all the valid country codes.



76
77
78
79
 
# File 'lib/tzinfo/country.rb', line 76

def self.all_codes
  load_index
  Indexes::Countries.countries.keys
end

.get(identifier) ⇒ Object

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



49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/tzinfo/country.rb', line 49

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) ⇒ Object

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



65
66
67
68
69
70
71
72
73
 
# File 'lib/tzinfo/country.rb', line 65

def self.new(identifier)      
  if identifier.kind_of?(CountryInfo)
    instance = super()
    instance.send :setup, identifier
    instance
  else
    get(identifier)
  end
end

Instance Method Details

#<=>(c) ⇒ Object

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.



139
140
141
 
# File 'lib/tzinfo/country.rb', line 139

def <=>(c)
  code <=> c.code
end

#_dump(limit) ⇒ Object

Dumps this Country for marshalling.



155
156
157
 
# File 'lib/tzinfo/country.rb', line 155

def _dump(limit)
  code
end

#code ⇒ Object

The ISO 3166 country code.



88
89
90
 
# File 'lib/tzinfo/country.rb', line 88

def code
  @info.code
end

#eql?(c) ⇒ Boolean

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

Returns:

  • (Boolean) 


145
146
147
 
# File 'lib/tzinfo/country.rb', line 145

def eql?(c)
  self == c
end

#hash ⇒ Object

Returns a hash value for this Country.



150
151
152
 
# File 'lib/tzinfo/country.rb', line 150

def hash
  code.hash
end

#inspect ⇒ Object

Returns internal object state as a programmer-readable string.



103
104
105
 
# File 'lib/tzinfo/country.rb', line 103

def inspect
  "#<#{self.class}: #{@info.code}>"
end

#name ⇒ Object

The name of the country.



93
94
95
 
# File 'lib/tzinfo/country.rb', line 93

def name
  @info.name
end

#to_s ⇒ Object

Alias for name.



98
99
100
 
# File 'lib/tzinfo/country.rb', line 98

def to_s
  name
end

#zone_identifiers ⇒ Object Also known as: zone_names

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).



111
112
113
 
# File 'lib/tzinfo/country.rb', line 111

def zone_identifiers
  @info.zone_identifiers
end

#zone_info ⇒ Object

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).



133
134
135
 
# File 'lib/tzinfo/country.rb', line 133

def zone_info
  @info.zones
end

#zones ⇒ Object

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).



122
123
124
125
126
 
# File 'lib/tzinfo/country.rb', line 122

def zones
  zone_identifiers.collect {|id|
    Timezone.get_proxy(id)        
  }
end