timezone 0.3.0 → 0.3.1

data/README.markdown

@@ -14,7 +14,8 @@ Then install your bundle.
 
 ## Getting Started
 
-Getting the current time or any historical time in any timezone, with daylight savings time taken into consideration, is easy:
+Getting the current time or any historical time in any timezone, with daylight
+savings time taken into consideration, is easy:
 
     timezone = Timezone::Zone.new :zone => 'America/Los_Angeles'
     timezone.time Time.now
@@ -22,7 +23,19 @@ Getting the current time or any historical time in any timezone, with daylight s
     timezone.time Time.utc(2010, 1, 1, 0, 0, 0)
     => 2009-12-31 16:00:00 UTC
 
-Time is always returned in the UTC timezone, but it accurately reflects the actual time in the specified timezone. The reason for this is that this function also takes into account daylight savings time, which can alter the timezone offset and hence put Ruby in the wrong timezone.
+Time is always returned in the UTC timezone, but it accurately reflects the
+actual time in the specified timezone. The reason for this is that this function
+also takes into account daylight savings time, which can alter the timezone
+offset and hence put Ruby in the wrong timezone.
+
+You can also query a `Timezone::Zone` object to determine if it was in Daylight
+Savings Time:
+
+    timezone = Timezone::Zone.new :zone => 'America/Los_Angeles'
+    timezone.dst?(Time.now)
+    => true
+    timezone.dst?(Time.utc(2010, 1, 1, 0, 0, 0))
+    => false
 
 ## Getting the timezone for a specific latitude and longitude
 

data/lib/timezone/version.rb

@@ -1,3 +1,3 @@
 module Timezone
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/lib/timezone/zone.rb

@@ -56,6 +56,11 @@ module Timezone
       reference.utc + rule_for_reference(reference)['offset']
     end
 
+    # Whether or not the time in the timezone is in DST.
+    def dst?(reference)
+      rule_for_reference(reference)['dst']
+    end
+
     # Get the current UTC offset in seconds for this timezone.
     #
     #   timezone.utc_offset(reference)
@@ -100,6 +105,7 @@ module Timezone
         list = self.names.select { |name| zones.include? name } # only select zones if they exist
 
         @zones = []
+        now = Time.now
         list.each do |zone|
           item = Zone.new(zone: zone)
           @zones << {
@@ -107,7 +113,7 @@ module Timezone
             :title => Configure.replacements[item.zone] || item.zone,
             :offset => item.utc_offset,
             :utc_offset => (item.utc_offset/(60*60)),
-            :dst => item.time(Time.now).dst?
+            :dst => item.dst?(now)
           }
         end
         @zones.sort_by! { |zone| zone[Configure.order_list_by] }

data/test/timezone_test.rb

@@ -1,6 +1,7 @@
 require 'timezone'
 require 'timezone/zone'
 require 'test/unit'
+require 'timecop'
 
 class TimezoneTest < Test::Unit::TestCase
   def test_valid_timezone
@@ -29,6 +30,15 @@ class TimezoneTest < Test::Unit::TestCase
     assert list.first[:zone] == "Australia/Sydney"
   end
 
+  def test_timezone_list
+    Timecop.freeze(Time.new(2012,2,2,0,0,0)) do
+      assert !Timezone::Zone.list('EST5EDT').first[:dst]
+    end
+    Timecop.freeze(Time.new(2013,6,6,0,0,0)) do
+      assert Timezone::Zone.list('EST5EDT').first[:dst]
+    end
+  end
+
   def test_timezone_custom_list_order
     Timezone::Configure.order_list_by = :title
     Timezone::Configure.replace "America/Chicago", with: "Chicago"

data/timezone.gemspec

@@ -23,4 +23,5 @@ Gem::Specification.new do |s|
 
   s.add_development_dependency('rake')
   s.add_development_dependency('minitest', '~> 4.0')
+  s.add_development_dependency('timecop')
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: timezone
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-11 00:00:00.000000000 Z
+date: 2013-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -43,6 +43,22 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A simple way to get accurate current and historical timezone information
   based on zone or latitude and longitude coordinates. This gem uses the tz database
   (http://www.twinsun.com/tz/tz-link.htm) for historical timezone information. It
@@ -581,7 +597,7 @@ rubyforge_project: timezone
 rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: timezone-0.3.0
+summary: timezone-0.3.1
 test_files:
 - test/data/Helsinki_rules_without_timestamps.json
 - test/data/asia