Class: Chronos::Zone

Inherits:
Struct
  • Object
show all
Defined in:
lib/chronos/zone.rb,
lib/chronos/zone.rb

Constant Summary collapse

Inspect = 
"#<%s:%s>"
Offset =

the UTC timezones, offset in seconds FIXME: as soon as rdoc stops sucking, use :‘<name>’ instead of ‘<name>’.to_sym (:stopdoc: proved useless, see earlier version in the git repo)

{
  "UTC-12".to_sym    => -43200, # I would love to use :'UTC-12', but rdoc fails with that
  "UTC-11".to_sym    => -39600,
  "UTC-10".to_sym    => -36000,
  "UTC-9:30".to_sym  => -34200,
  "UTC-9".to_sym     => -32400,
  "UTC-8".to_sym     => -28800,
  "UTC-7".to_sym     => -25200,
  "UTC-6".to_sym     => -21600,
  "UTC-5".to_sym     => -18000,
  "UTC-4:30".to_sym  => -16200,
  "UTC-4".to_sym     => -14400,
  "UTC-3:30".to_sym  => -12600,
  "UTC-3".to_sym     => -10800,
  "UTC-2".to_sym     =>  -7200,
  "UTC-1".to_sym     =>  -3600,
  "UTC".to_sym       =>      0,
  "UTC+1".to_sym     =>   3600,
  "UTC+2".to_sym     =>   7200,
  "UTC+3".to_sym     =>  10800,
  "UTC+3:07".to_sym  =>  11224,
  "UTC+3:30".to_sym  =>  12600,
  "UTC+4".to_sym     =>  14400,
  "UTC+4:30".to_sym  =>  16200,
  "UTC+5".to_sym     =>  18000,
  "UTC+5:30".to_sym  =>  19800,
  "UTC+5:45".to_sym  =>  20700,
  "UTC+6".to_sym     =>  21600,
  "UTC+6:30".to_sym  =>  23400,
  "UTC+7".to_sym     =>  25200,
  "UTC+8".to_sym     =>  28800,
  "UTC+8:45".to_sym  =>  31500,
  "UTC+9".to_sym     =>  32400,
  "UTC+9:30".to_sym  =>  34200,
  "UTC+10".to_sym    =>  36000,
  "UTC+10:30".to_sym =>  37800,
  "UTC+11".to_sym    =>  39600,
  "UTC+11:30".to_sym =>  41400,
  "UTC+12".to_sym    =>  43200,
  "UTC+12:45".to_sym =>  45900,
  "UTC+13".to_sym    =>  46800,
  "UTC+14".to_sym    =>  50400,
}
Map =

map old/military timezone names to UTC corresponding utc, isDST

Hash.new { |hash, key| key }.merge!({
  # for ::DateTime
  '-12:00'   => ['utc-12',   false],
  '-11:00'   => ['utc-11',   false],
  '-10:00'   => ['utc-10',   false],
  '-09:00'   => ['utc-9',    false],
  '-08:00'   => ['utc-8',    false],
  '-07:00'   => ['utc-7',    false],
  '-06:00'   => ['utc-6',    false],
  '-05:00'   => ['utc-5',    false],
  '-04:30'   => ['utc-4:30', false],
  '-04:00'   => ['utc-4',    false],
  '-03:00'   => ['utc-3',    false],
  '-03:30'   => ['utc-3:30', false],
  '-02:00'   => ['utc-2',    false],
  '-01:00'   => ['utc-1',    false],
  '+00:00'   => ['utc',      false],
  '+01:00'   => ['utc+1',    false],
  '+02:00'   => ['utc+2',    false],
  '+03:00'   => ['utc+3',    false],
  '+03:30'   => ['utc+3:30', false],
  '+04:00'   => ['utc+4',    false],
  '+05:00'   => ['utc+5',    false],
  '+05:30'   => ['utc+5:30', false],
  '+06:00'   => ['utc+6',    false],
  '+07:00'   => ['utc+7',    false],
  '+08:00'   => ['utc+8',    false],
  '+09:00'   => ['utc+9',    false],
  '+09:30'   => ['utc+9:30', false],
  '+10:00'   => ['utc+10',   false],
  '+11:00'   => ['utc+11',   false],
  '+12:00'   => ['utc+12',   false],
  # military & old
  'yankee'   => ['utc-12',   false],
  'xray'     => ['utc-11',   false],
  'hst'      => ['utc-10',   false],
  'whisky'   => ['utc-10',   false],
  'akst'     => ['utc-9',    false],
  'akdt'     => ['utc-9',    true],
  'ydt'      => ['utc-9',    true],
  'victor'   => ['utc-9',    false],
  'pst'      => ['utc-8',    false],
  'pdt'      => ['utc-8',    true],
  'uniform'  => ['utc-8',    false],
  'mst'      => ['utc-7',    false],
  'mdt'      => ['utc-7',    true],
  'tango'    => ['utc-7',    false],
  'cst'      => ['utc-6',    false],
  'cdt'      => ['utc-6',    true],
  'sierra'   => ['utc-6',    false],
  'est'      => ['utc-5',    false],
  'edt'      => ['utc-5',    true],
  'romeo'    => ['utc-5',    false],
  'vst'      => ['utc-4:30', false],
  'ast'      => ['utc-4',    false],
  'adt'      => ['utc-4',    true],
  'quebec'   => ['utc-4',    false],
  'nst'      => ['utc-3:30', false],
  'ndt'      => ['utc-3:30', true],
  'papa'     => ['utc-3',    false],
  'oscar'    => ['utc-2',    false],
  'november' => ['utc-1',    false],
  'gmt'      => ['utc',      false],
  'wet'      => ['utc',      false],
  'zulu'     => ['utc',      false],
  'cet'      => ['utc+1',    false],
  'cest'     => ['utc+1',    true],
  'alpha'    => ['utc+1',    false],
  'bravo'    => ['utc+2',    false],
  'msk'      => ['utc+3',    false],
  'charlie'  => ['utc+3',    false],
  'delta'    => ['utc+4',    false],
  'echo'     => ['utc+5',    false],
  'ist'      => ['utc+5:30', false],
  'foxtrot'  => ['utc+6',    false],
  'golf'     => ['utc+7',    false],
  'awst'     => ['utc+8',    false],
  'hotel'    => ['utc+8',    false],
  'india'    => ['utc+9',    false],
  'acst'     => ['utc+9:30', false],
  'aest'     => ['utc+10',   false],
  'kilo'     => ['utc+10',   false],
  'lima'     => ['utc+11',   false],
  'mike'     => ['utc+12',   false]
})

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#alpha2 ⇒ Object

Returns the value of attribute alpha2

Returns:

  • the current value of alpha2



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def alpha2
  @alpha2
end

#alpha3 ⇒ Object

Returns the value of attribute alpha3

Returns:

  • the current value of alpha3



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def alpha3
  @alpha3
end

#country ⇒ Object

Returns the value of attribute country

Returns:

  • the current value of country



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def country
  @country
end

#dstrule ⇒ Object

Returns the value of attribute dstrule

Returns:

  • the current value of dstrule



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def dstrule
  @dstrule
end

#language ⇒ Object

Returns the value of attribute language

Returns:

  • the current value of language



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def language
  @language
end

#latitude ⇒ Object

Returns the value of attribute latitude

Returns:

  • the current value of latitude



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def latitude
  @latitude
end

#latitude_iso ⇒ Object

Returns the value of attribute latitude_iso

Returns:

  • the current value of latitude_iso



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def latitude_iso
  @latitude_iso
end

#longitude ⇒ Object

Returns the value of attribute longitude

Returns:

  • the current value of longitude



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def longitude
  @longitude
end

#longitude_iso ⇒ Object

Returns the value of attribute longitude_iso

Returns:

  • the current value of longitude_iso



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def longitude_iso
  @longitude_iso
end

#numeric ⇒ Object

Returns the value of attribute numeric

Returns:

  • the current value of numeric



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def numeric
  @numeric
end

#offset ⇒ Object

Returns the value of attribute offset

Returns:

  • the current value of offset



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def offset
  @offset
end

#timezone_id ⇒ Object

Returns the value of attribute timezone_id

Returns:

  • the current value of timezone_id



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def timezone_id
  @timezone_id
end

#utc ⇒ Object

Returns the value of attribute utc

Returns:

  • the current value of utc



10
11
12
 
# File 'lib/chronos/zone.rb', line 10

def utc
  @utc
end

Class Method Details

.[](name) ⇒ Object 



195
196
197
198
199
200
201
202
 
# File 'lib/chronos/zone.rb', line 195

def self.[](name)
  name = name.to_s.downcase
  if zone = @by_name[name] then
    zone
  elsif mapped = Map[name]
    @by_name[mapped.first]
  end
end

.load(tabfile, marshalfile = nil, marshal = true) ⇒ Object

load locations from a tabfile



167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
 
# File 'lib/chronos/zone.rb', line 167

def self.load(tabfile, marshalfile=nil, marshal=true)
  if marshalfile && File.readable?(marshalfile) && File.mtime(tabfile) <= File.mtime(marshalfile) then
    @by_name.update(Marshal.load(File.read(marshalfile)))
  else
    data = {}
    File.foreach(tabfile) { |line|
      next if line[0] == ?#
      tmp                    = line.chomp.split("\t")
      tmp[3,0]               = 0
      location               = new(*tmp)
      location.utc           = location.utc.to_sym
      location.offset        = Offset[location.utc]
      location.numeric       = Integer(location.numeric) rescue nil
      location.latitude      = Float(location.latitude) rescue nil
      location.longitude     = Float(location.longitude) rescue nil
      location.latitude_iso  = Integer(location.latitude_iso) rescue nil
      location.longitude_iso = Integer(location.longitude_iso) rescue nil
      data[location.timezone_id.downcase] = location
    }
    @by_name.update(data)
    if marshalfile && marshal then
      File.open(marshalfile, "wb") { |fh|
        fh.write(Marshal.dump(data))
      }
    end
  end
end

Instance Method Details

#inspect ⇒ Object 



208
209
210
 
# File 'lib/chronos/zone.rb', line 208

def inspect
  sprintf Inspect, self.class, timezone_id
end

#zone_names ⇒ Object 



204
205
206
 
# File 'lib/chronos/zone.rb', line 204

def zone_names
  @by_name.keys
end