tzinfo 0.0.1

data/README

@@ -0,0 +1,87 @@
+= TZInfo -- Daylight-savings aware timezone support for Ruby
+
+TZInfo uses the tz database (http://www.twinsun.com/tz/tz-link.htm) to provide
+daylight-savings aware transformations between times in different timezones.
+This is the same database as used for zoneinfo on Unix machines.
+
+The tz database has been imported (using TZDataParser) and turned into a set of
+Ruby classes (which are packaged with this release).
+
+
+== Example usage
+
+To convert a time in UTC, to a local time in the America/New_York timezone, you
+can do the following:
+
+  require_gem 'tzinfo'
+  include TZInfo
+  
+  tz = Timezone.get('America/New_York')
+  local = tz.utc_to_local(DateTime.new(2005,8,29,15,35,0))
+  
+To convert from a local time to UTC, the local_to_utc method can be used:
+
+  utc = tz.local_to_utc(local)
+  
+To get information about the rules in force at a particular UTC or local time,
+the Timezone.period_for_utc and Timezone.period_for_local methods can be used.
+Both of these methods return TimezonePeriod objects. The following gets the 
+identifier for the period (in this case EDT).
+
+  period = tz.period_for_utc(DateTime.new(2005,8,29,15,35,0))
+  id = period.zone_identifier
+  
+In all the above examples, instances of Time can be used instead of DateTime.
+Timezone.utc_to_local and Timezone.local_to_utc both return the type they are 
+passed.
+
+You can get the current local time in a Timezone with the Timezone.now method:
+
+  now = tz.now
+  
+You can also access Timezones by Country (ISO 3166 country code). The following 
+gets all the Timezone identifiers for the US:
+
+  us = Country.get('US')
+  timezones = us.all_codes
+  
+The above covers the most common uses of Timezone and Country. For more detail,
+see their individual class documentation.
+
+
+== Download
+
+The latest version of TZInfo can be found at
+
+* http://rubyforge.org/frs/?group_id=894
+
+Documentation can be found at 
+
+* http://tzinfo.rubyforge.org/doc/
+
+
+== Installation
+
+The preferred method of installing TZInfo is through its GEM file (RubyGems[http://docs.rubygems.org/] required):
+
+  % gem install tzinfo-0.0.1.gem
+  
+or to automatically download and install:
+
+  % gem install tzinfo --remote
+  
+
+== License
+
+TZInfo is released under the MIT[http://opensource.org/licenses/mit-license.html] license.
+
+
+== Issues
+
+* It currently takes an extremely long time to generate all the Ruby Timezone classes from the tz data. This process could do with some optimization.
+* Test cases need to be written.
+
+== Support
+
+Please contact Philip Ross (phil.ross@gmail.com) if you require assistance or have
+any suggestions.

data/lib/tzinfo.rb

@@ -0,0 +1,25 @@
+#--
+# Copyright (c) 2005 Philip Ross
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of 
+# this software and associated documentation files (the "Software"), to deal in 
+# the Software without restriction, including without limitation the rights to 
+# use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies 
+# of the Software, and to permit persons to whom the Software is furnished to do 
+# so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all 
+# copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 
+# THE SOFTWARE.
+#++
+
+require 'tzinfo/timezone'
+require 'tzinfo/country'
+require 'tzinfo/tzdataparser'

data/lib/tzinfo/countries/AD.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AD < Country #:nodoc:
+def initialize
+  super
+  set_code('AD')
+  set_name('Andorra')
+  add_zone('Europe/Andorra')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AE.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AE < Country #:nodoc:
+def initialize
+  super
+  set_code('AE')
+  set_name('United Arab Emirates')
+  add_zone('Asia/Dubai')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AF.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AF < Country #:nodoc:
+def initialize
+  super
+  set_code('AF')
+  set_name('Afghanistan')
+  add_zone('Asia/Kabul')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AG.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AG < Country #:nodoc:
+def initialize
+  super
+  set_code('AG')
+  set_name('Antigua & Barbuda')
+  add_zone('America/Antigua')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AI.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AI < Country #:nodoc:
+def initialize
+  super
+  set_code('AI')
+  set_name('Anguilla')
+  add_zone('America/Anguilla')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AL.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AL < Country #:nodoc:
+def initialize
+  super
+  set_code('AL')
+  set_name('Albania')
+  add_zone('Europe/Tirane')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AM.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AM < Country #:nodoc:
+def initialize
+  super
+  set_code('AM')
+  set_name('Armenia')
+  add_zone('Asia/Yerevan')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AN.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AN < Country #:nodoc:
+def initialize
+  super
+  set_code('AN')
+  set_name('Netherlands Antilles')
+  add_zone('America/Curacao')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AO.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AO < Country #:nodoc:
+def initialize
+  super
+  set_code('AO')
+  set_name('Angola')
+  add_zone('Africa/Luanda')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AQ.rb

@@ -0,0 +1,27 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AQ < Country #:nodoc:
+def initialize
+  super
+  set_code('AQ')
+  set_name('Antarctica')
+  add_zone('Antarctica/Davis')
+  add_zone('Antarctica/Mawson')
+  add_zone('Antarctica/Syowa')
+  add_zone('Antarctica/Casey')
+  add_zone('Antarctica/South_Pole')
+  add_zone('Antarctica/Vostok')
+  add_zone('Antarctica/Rothera')
+  add_zone('Antarctica/McMurdo')
+  add_zone('Antarctica/DumontDUrville')
+  add_zone('Antarctica/Palmer')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AR.rb

@@ -0,0 +1,27 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AR < Country #:nodoc:
+def initialize
+  super
+  set_code('AR')
+  set_name('Argentina')
+  add_zone('America/Argentina/Mendoza')
+  add_zone('America/Argentina/Buenos_Aires')
+  add_zone('America/Argentina/La_Rioja')
+  add_zone('America/Argentina/San_Juan')
+  add_zone('America/Argentina/Jujuy')
+  add_zone('America/Argentina/Ushuaia')
+  add_zone('America/Argentina/Rio_Gallegos')
+  add_zone('America/Argentina/Cordoba')
+  add_zone('America/Argentina/Catamarca')
+  add_zone('America/Argentina/Tucuman')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AS.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AS < Country #:nodoc:
+def initialize
+  super
+  set_code('AS')
+  set_name('Samoa (American)')
+  add_zone('Pacific/Pago_Pago')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AT.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AT < Country #:nodoc:
+def initialize
+  super
+  set_code('AT')
+  set_name('Austria')
+  add_zone('Europe/Vienna')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AU.rb

@@ -0,0 +1,28 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AU < Country #:nodoc:
+def initialize
+  super
+  set_code('AU')
+  set_name('Australia')
+  add_zone('Australia/Lindeman')
+  add_zone('Australia/Sydney')
+  add_zone('Australia/Adelaide')
+  add_zone('Australia/Darwin')
+  add_zone('Australia/Hobart')
+  add_zone('Australia/Perth')
+  add_zone('Australia/Broken_Hill')
+  add_zone('Australia/Currie')
+  add_zone('Australia/Brisbane')
+  add_zone('Australia/Lord_Howe')
+  add_zone('Australia/Melbourne')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AW.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AW < Country #:nodoc:
+def initialize
+  super
+  set_code('AW')
+  set_name('Aruba')
+  add_zone('America/Aruba')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end

data/lib/tzinfo/countries/AX.rb

@@ -0,0 +1,18 @@
+require 'tzinfo/country'
+module TZInfo #:nodoc:
+module Countries #:nodoc:
+class AX < Country #:nodoc:
+def initialize
+  super
+  set_code('AX')
+  set_name('Aaland Islands')
+  add_zone('Europe/Mariehamn')
+  zones_added
+end
+@@instance = new
+def self.instance
+   @@instance
+end
+end
+end
+end