Class: TZInfo::CountryTimezone

Inherits:
Object
  • Object
show all
Defined in:
lib/tzinfo/country_timezone.rb

Overview

A Timezone within a Country. This contains extra information about the Timezone that is specific to the Country (a Timezone could be used by multiple countries).

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(identifier, latitude_numerator, latitude_denominator, longitude_numerator, longitude_denominator, description = nil) ⇒ CountryTimezone

Creates a new CountryTimezone with a timezone identifier, latitude, longitude and description. The latitude and longitude are specified as rationals - a numerator and denominator. For performance reasons, the numerators and denominators must be specified in their lowest form.

CountryTimezone instances should not normally be constructed manually.



42
43
44
45
46
47
48
49
50
 
# File 'lib/tzinfo/country_timezone.rb', line 42

def initialize(identifier, latitude_numerator, latitude_denominator, 
               longitude_numerator, longitude_denominator, description = nil) #:nodoc:
  @identifier = identifier
  @latitude_numerator = latitude_numerator
  @latitude_denominator = latitude_denominator
  @longitude_numerator = longitude_numerator
  @longitude_denominator = longitude_denominator      
  @description = description
end

Instance Attribute Details

#description ⇒ Object (readonly)

A description of this timezone in relation to the country, e.g. “Eastern Time”. This is usually nil for countries having only a single Timezone.



34
35
36
 
# File 'lib/tzinfo/country_timezone.rb', line 34

def description
  @description
end

#identifier ⇒ Object (readonly)

The zone identifier.



29
30
31
 
# File 'lib/tzinfo/country_timezone.rb', line 29

def identifier
  @identifier
end

Instance Method Details

#==(ct) ⇒ Object

Returns true if and only if the given CountryTimezone is equal to the current CountryTimezone (has the same identifer, latitude, longitude and description).



76
77
78
79
80
81
 
# File 'lib/tzinfo/country_timezone.rb', line 76

def ==(ct)
  ct.respond_to?(:identifier) && ct.respond_to?(:latitude) &&
  ct.respond_to?(:longitude)  && ct.respond_to?(:description) &&
  identifier == ct.identifier  && latitude == ct.latitude &&
  longitude == ct.longitude   && description == ct.description         
end

#description_or_friendly_identifier ⇒ Object

if description is not nil, this method returns description; otherwise it returns timezone.friendly_identifier(true).



59
60
61
 
# File 'lib/tzinfo/country_timezone.rb', line 59

def description_or_friendly_identifier
  description || timezone.friendly_identifier(true)
end

#eql?(ct) ⇒ Boolean

Returns true if and only if the given CountryTimezone is equal to the current CountryTimezone (has the same identifer, latitude, longitude and description).

Returns:

  • (Boolean) 


86
87
88
 
# File 'lib/tzinfo/country_timezone.rb', line 86

def eql?(ct)
  self == ct
end

#hash ⇒ Object

Returns a hash of this CountryTimezone.



91
92
93
94
 
# File 'lib/tzinfo/country_timezone.rb', line 91

def hash
  @identifier.hash ^ @latitude_numerator.hash ^ @latitude_denominator.hash ^ 
    @longitude_numerator.hash ^ @longitude_denominator.hash ^ @description.hash
end

#inspect ⇒ Object

Returns internal object state as a programmer-readable string.



97
98
99
 
# File 'lib/tzinfo/country_timezone.rb', line 97

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

#latitude ⇒ Object

The latitude of this timezone in degrees as a Rational.



64
65
66
 
# File 'lib/tzinfo/country_timezone.rb', line 64

def latitude
  @latitude ||= RubyCoreSupport.rational_new!(@latitude_numerator, @latitude_denominator)
end

#longitude ⇒ Object

The longitude of this timezone in degrees as a Rational.



69
70
71
 
# File 'lib/tzinfo/country_timezone.rb', line 69

def longitude
  @longitude ||= RubyCoreSupport.rational_new!(@longitude_numerator, @longitude_denominator)
end

#timezone ⇒ Object

The Timezone (actually a TimezoneProxy for performance reasons).



53
54
55
 
# File 'lib/tzinfo/country_timezone.rb', line 53

def timezone
  Timezone.get_proxy(@identifier)
end