tzinfo 1.2.11 → 2.0.0

data/lib/tzinfo/time_or_datetime.rb

@@ -1,351 +0,0 @@
-require 'date'
-require 'rational' unless defined?(Rational)
-require 'time'
-
-module TZInfo
-  # Used by TZInfo internally to represent either a Time, DateTime or
-  # an Integer timestamp (seconds since 1970-01-01 00:00:00).
-  class TimeOrDateTime
-    include Comparable
-    
-    # Constructs a new TimeOrDateTime. timeOrDateTime can be a Time, DateTime
-    # or Integer. If using a Time or DateTime, any time zone information 
-    # is ignored.
-    #
-    # Integer timestamps must be within the range supported by Time on the
-    # platform being used.    
-    def initialize(timeOrDateTime)
-      @time = nil
-      @datetime = nil
-      @timestamp = nil
-      
-      if timeOrDateTime.is_a?(Time)
-        @time = timeOrDateTime
-        
-        # Avoid using the slower Rational class unless necessary.
-        nsec = RubyCoreSupport.time_nsec(@time)
-        usec = nsec % 1000 == 0 ? nsec / 1000 : Rational(nsec, 1000)
-        
-        @time = Time.utc(@time.year, @time.mon, @time.mday, @time.hour, @time.min, @time.sec, usec) unless @time.utc?        
-        @orig = @time
-      elsif timeOrDateTime.is_a?(DateTime)
-        @datetime = timeOrDateTime
-        @datetime = @datetime.new_offset(0) unless @datetime.offset == 0
-        @orig = @datetime
-      else
-        @timestamp = timeOrDateTime.to_i
-        
-        if !RubyCoreSupport.time_supports_64bit && (@timestamp > 2147483647 || @timestamp < -2147483648 || (@timestamp < 0 && !RubyCoreSupport.time_supports_negative))
-          raise RangeError, 'Timestamp is outside the supported range of Time on this platform'
-        end
-        
-        @orig = @timestamp
-      end
-    end
-    
-    # Returns the time as a Time.
-    #
-    # When converting from a DateTime, the result is truncated to microsecond
-    # precision.
-    def to_time
-      # Thread-safety: It is possible that the value of @time may be 
-      # calculated multiple times in concurrently executing threads. It is not 
-      # worth the overhead of locking to ensure that @time is only 
-      # calculated once.
-    
-      unless @time
-        result = if @timestamp
-          Time.at(@timestamp).utc
-        else
-          Time.utc(year, mon, mday, hour, min, sec, usec)
-        end
-
-        return result if frozen?
-        @time = result
-      end
-      
-      @time      
-    end
-    
-    # Returns the time as a DateTime.
-    #
-    # When converting from a Time, the result is truncated to microsecond
-    # precision.
-    def to_datetime
-      # Thread-safety: It is possible that the value of @datetime may be 
-      # calculated multiple times in concurrently executing threads. It is not 
-      # worth the overhead of locking to ensure that @datetime is only 
-      # calculated once.
-    
-      unless @datetime
-        # Avoid using Rational unless necessary.
-        u = usec
-        s = u == 0 ? sec : Rational(sec * 1000000 + u, 1000000)
-        result = RubyCoreSupport.datetime_new(year, mon, mday, hour, min, s)
-        return result if frozen?
-        @datetime = result
-      end
-      
-      @datetime
-    end
-    
-    # Returns the time as an integer timestamp.
-    def to_i
-      # Thread-safety: It is possible that the value of @timestamp may be 
-      # calculated multiple times in concurrently executing threads. It is not 
-      # worth the overhead of locking to ensure that @timestamp is only 
-      # calculated once.
-    
-      unless @timestamp
-        result = to_time.to_i
-        return result if frozen?
-        @timestamp = result
-      end
-      
-      @timestamp
-    end
-    
-    # Returns the time as the original time passed to new.
-    def to_orig
-      @orig
-    end
-    
-    # Returns a string representation of the TimeOrDateTime.
-    def to_s
-      if @orig.is_a?(Time)
-        "Time: #{@orig.to_s}"
-      elsif @orig.is_a?(DateTime)
-        "DateTime: #{@orig.to_s}"
-      else
-        "Timestamp: #{@orig.to_s}"
-      end
-    end
-    
-    # Returns internal object state as a programmer-readable string.
-    def inspect
-      "#<#{self.class}: #{@orig.inspect}>"
-    end
-    
-    # Returns the year.
-    def year
-      if @time
-        @time.year
-      elsif @datetime
-        @datetime.year
-      else
-        to_time.year
-      end
-    end
-    
-    # Returns the month of the year (1..12).
-    def mon
-      if @time
-        @time.mon
-      elsif @datetime
-        @datetime.mon
-      else
-        to_time.mon
-      end
-    end
-    alias :month :mon
-    
-    # Returns the day of the month (1..n).
-    def mday
-      if @time
-        @time.mday
-      elsif @datetime
-        @datetime.mday
-      else
-        to_time.mday
-      end
-    end
-    alias :day :mday
-
-    # Returns the day of the week (0..6 for Sunday to Saturday).
-    def wday
-      if @time
-        @time.wday
-      elsif @datetime
-        @datetime.wday
-      else
-        to_time.wday
-      end
-    end
-    
-    # Returns the hour of the day (0..23).
-    def hour
-      if @time
-        @time.hour
-      elsif @datetime
-        @datetime.hour
-      else
-        to_time.hour
-      end
-    end
-    
-    # Returns the minute of the hour (0..59).
-    def min
-      if @time
-        @time.min
-      elsif @datetime
-        @datetime.min
-      else
-        to_time.min
-      end
-    end
-    
-    # Returns the second of the minute (0..60). (60 for a leap second).
-    def sec
-      if @time
-        @time.sec
-      elsif @datetime
-        @datetime.sec
-      else
-        to_time.sec
-      end
-    end
-    
-    # Returns the number of microseconds for the time.
-    def usec      
-      if @time
-        @time.usec
-      elsif @datetime
-        # Ruby 1.8 has sec_fraction (of which the documentation says
-        # 'I do NOT recommend you to use this method'). sec_fraction no longer
-        # exists in Ruby 1.9.
-        
-        # Calculate the sec_fraction from the day_fraction.
-        ((@datetime.day_fraction - OffsetRationals.rational_for_offset(@datetime.hour * 3600 + @datetime.min * 60 + @datetime.sec)) * 86400000000).to_i
-      else 
-        0
-      end
-    end
-    
-    # Compares this TimeOrDateTime with another Time, DateTime, timestamp 
-    # (Integer) or TimeOrDateTime. Returns -1, 0 or +1 depending 
-    # whether the receiver is less than, equal to, or greater than 
-    # timeOrDateTime.
-    #
-    # Returns nil if the passed in timeOrDateTime is not comparable with 
-    # TimeOrDateTime instances.
-    #
-    # Comparisons involving a DateTime will be performed using DateTime#<=>.
-    # Comparisons that don't involve a DateTime, but include a Time will be
-    # performed with Time#<=>. Otherwise comparisons will be performed with
-    # Integer#<=>.    
-    def <=>(timeOrDateTime)
-      return nil unless timeOrDateTime.is_a?(TimeOrDateTime) || 
-                        timeOrDateTime.is_a?(Time) ||
-                        timeOrDateTime.is_a?(DateTime) ||
-                        timeOrDateTime.respond_to?(:to_i)
-    
-      unless timeOrDateTime.is_a?(TimeOrDateTime)
-        timeOrDateTime = TimeOrDateTime.wrap(timeOrDateTime)
-      end
-          
-      orig = timeOrDateTime.to_orig
-      
-      if @orig.is_a?(DateTime) || orig.is_a?(DateTime)
-        # If either is a DateTime, assume it is there for a reason 
-        # (i.e. for its larger range of acceptable values on 32-bit systems).
-        to_datetime <=> timeOrDateTime.to_datetime
-      elsif @orig.is_a?(Time) || orig.is_a?(Time)
-        to_time <=> timeOrDateTime.to_time
-      else
-        to_i <=> timeOrDateTime.to_i
-      end
-    end
-    
-    # Adds a number of seconds to the TimeOrDateTime. Returns a new 
-    # TimeOrDateTime, preserving what the original constructed type was.
-    # If the original type is a Time and the resulting calculation goes out of
-    # range for Times, then an exception will be raised by the Time class.
-    def +(seconds)
-      if seconds == 0
-        self
-      else
-        if @orig.is_a?(DateTime)
-          TimeOrDateTime.new(@orig + OffsetRationals.rational_for_offset(seconds))
-        else
-          # + defined for Time and Integer
-          TimeOrDateTime.new(@orig + seconds)
-        end
-      end
-    end
-    
-    # Subtracts a number of seconds from the TimeOrDateTime. Returns a new 
-    # TimeOrDateTime, preserving what the original constructed type was.
-    # If the original type is a Time and the resulting calculation goes out of
-    # range for Times, then an exception will be raised by the Time class.
-    def -(seconds)
-      self + (-seconds)
-    end
-   
-    # Similar to the + operator, but converts to a DateTime based TimeOrDateTime
-    # where the  Time or Integer timestamp to go out of the allowed range for a 
-    # Time, converts to a DateTime based TimeOrDateTime.
-    #
-    # Note that the range of Time varies based on the platform.
-    def add_with_convert(seconds)
-      if seconds == 0
-        self
-      else
-        if @orig.is_a?(DateTime)
-          TimeOrDateTime.new(@orig + OffsetRationals.rational_for_offset(seconds))
-        else
-          # A Time or timestamp.
-          result = to_i + seconds
-          
-          if ((result > 2147483647 || result < -2147483648) && !RubyCoreSupport.time_supports_64bit) || (result < 0 && !RubyCoreSupport.time_supports_negative)
-            result = TimeOrDateTime.new(to_datetime + OffsetRationals.rational_for_offset(seconds))
-          else
-            result = TimeOrDateTime.new(@orig + seconds)
-          end
-        end
-      end
-    end
-    
-    # Returns true if todt represents the same time and was originally 
-    # constructed with the same type (DateTime, Time or timestamp) as this 
-    # TimeOrDateTime.
-    def eql?(todt)
-      todt.kind_of?(TimeOrDateTime) && to_orig.eql?(todt.to_orig)      
-    end
-    
-    # Returns a hash of this TimeOrDateTime.
-    def hash
-      @orig.hash
-    end
-    
-    # If no block is given, returns a TimeOrDateTime wrapping the given 
-    # timeOrDateTime. If a block is specified, a TimeOrDateTime is constructed
-    # and passed to the block. The result of the block must be a TimeOrDateTime.
-    #
-    # The result of the block will be converted to the type of the originally 
-    # passed in timeOrDateTime and then returned as the result of wrap.
-    #
-    # timeOrDateTime can be a Time, DateTime, timestamp (Integer) or 
-    # TimeOrDateTime. If a TimeOrDateTime is passed in, no new TimeOrDateTime 
-    # will be constructed and the value passed to wrap will be used when 
-    # calling the block.
-    def self.wrap(timeOrDateTime)      
-      t = timeOrDateTime.is_a?(TimeOrDateTime) ? timeOrDateTime : TimeOrDateTime.new(timeOrDateTime)        
-      
-      if block_given?
-        t = yield t
-        
-        if timeOrDateTime.is_a?(TimeOrDateTime)
-          t
-        elsif timeOrDateTime.is_a?(Time)
-          t.to_time
-        elsif timeOrDateTime.is_a?(DateTime)
-          t.to_datetime
-        else
-          t.to_i
-        end        
-      else
-        t
-      end
-    end
-  end
-end

data/lib/tzinfo/timezone_definition.rb

@@ -1,36 +0,0 @@
-module TZInfo
-  
-  # TimezoneDefinition is included into Timezone definition modules.
-  # TimezoneDefinition provides the methods for defining timezones.
-  #
-  # @private
-  module TimezoneDefinition #:nodoc:
-    # Add class methods to the includee.
-    def self.append_features(base)
-      super
-      base.extend(ClassMethods)
-    end
-    
-    # Class methods for inclusion.
-    #
-    # @private
-    module ClassMethods #:nodoc:
-      # Returns and yields a TransitionDataTimezoneInfo object to define a 
-      # timezone.
-      def timezone(identifier)
-        yield @timezone = TransitionDataTimezoneInfo.new(identifier)
-      end
-      
-      # Defines a linked timezone.
-      def linked_timezone(identifier, link_to_identifier)
-        @timezone = LinkedTimezoneInfo.new(identifier, link_to_identifier)
-      end
-      
-      # Returns the last TimezoneInfo to be defined with timezone or 
-      # linked_timezone.
-      def get
-        @timezone
-      end
-    end
-  end
-end

data/lib/tzinfo/timezone_index_definition.rb

@@ -1,54 +0,0 @@
-module TZInfo
-  # The timezone index file includes TimezoneIndexDefinition which provides
-  # methods used to define timezones in the index.
-  #
-  # @private
-  module TimezoneIndexDefinition #:nodoc:
-    # Add class methods to the includee and initialize class instance variables.
-    def self.append_features(base)
-      super
-      base.extend(ClassMethods)
-      base.instance_eval do
-        @timezones = []
-        @data_timezones = []
-        @linked_timezones = []
-      end
-    end
-    
-    # Class methods for inclusion.
-    #
-    # @private
-    module ClassMethods #:nodoc:
-      # Defines a timezone based on data.
-      def timezone(identifier)
-        @timezones << identifier
-        @data_timezones << identifier
-      end
-      
-      # Defines a timezone which is a link to another timezone.
-      def linked_timezone(identifier)
-        @timezones << identifier
-        @linked_timezones << identifier
-      end
-      
-      # Returns a frozen array containing the identifiers of all the timezones.
-      # Identifiers appear in the order they were defined in the index.
-      def timezones
-        @timezones.freeze
-      end
-      
-      # Returns a frozen array containing the identifiers of all data timezones.
-      # Identifiers appear in the order they were defined in the index.
-      def data_timezones
-        @data_timezones.freeze
-      end
-      
-      # Returns a frozen array containing the identifiers of all linked
-      # timezones. Identifiers appear in the order they were defined in 
-      # the index.
-      def linked_timezones
-        @linked_timezones.freeze
-      end      
-    end
-  end
-end

data/lib/tzinfo/timezone_info.rb

@@ -1,30 +0,0 @@
-module TZInfo
-  # Represents a timezone defined by a data source.
-  class TimezoneInfo
-    
-    # The timezone identifier.
-    attr_reader :identifier
-    
-    # Constructs a new TimezoneInfo with an identifier.
-    def initialize(identifier)
-      @identifier = identifier
-    end
-    
-    # Returns internal object state as a programmer-readable string.
-    def inspect
-      "#<#{self.class}: #@identifier>"
-    end
-    
-    # Constructs a Timezone instance for the timezone represented by this
-    # TimezoneInfo.
-    def create_timezone
-      raise_not_implemented('create_timezone')
-    end
-
-    private
-
-    def raise_not_implemented(method_name)
-      raise NotImplementedError, "Subclasses must override #{method_name}"
-    end
-  end
-end

data/lib/tzinfo/timezone_transition_definition.rb

@@ -1,104 +0,0 @@
-module TZInfo
-  # A TimezoneTransition defined by as integer timestamp, as a rational to
-  # create a DateTime or as both.
-  #
-  # @private 
-  class TimezoneTransitionDefinition < TimezoneTransition #:nodoc:
-    # The numerator of the DateTime if the transition time is defined as a 
-    # DateTime, otherwise the transition time as a timestamp.
-    attr_reader :numerator_or_time
-    protected :numerator_or_time
-    
-    # Either the denominator of the DateTime if the transition time is defined
-    # as a DateTime, otherwise nil. 
-    attr_reader :denominator
-    protected :denominator
-    
-    # Creates a new TimezoneTransitionDefinition with the given offset, 
-    # previous_offset (both TimezoneOffset instances) and UTC time.
-    #
-    # The time can be specified as a timestamp, as a rational to create a
-    # DateTime, or as both.
-    #
-    # If both a timestamp and rational are given, then the rational will only
-    # be used if the timestamp falls outside of the range of Time on the
-    # platform being used at runtime.
-    #
-    # DateTimes are created from the rational as follows:
-    # 
-    #  RubyCoreSupport.datetime_new!(RubyCoreSupport.rational_new!(numerator, denominator), 0, Date::ITALY)
-    #
-    # For performance reasons, the numerator and denominator must be specified
-    # in their lowest form.
-    def initialize(offset, previous_offset, numerator_or_timestamp, denominator_or_numerator = nil, denominator = nil)
-      super(offset, previous_offset)
-      
-      if denominator
-        numerator = denominator_or_numerator
-        timestamp = numerator_or_timestamp
-      elsif denominator_or_numerator
-        numerator = numerator_or_timestamp
-        denominator = denominator_or_numerator
-        timestamp = nil
-      else
-        numerator = nil
-        denominator = nil
-        timestamp = numerator_or_timestamp
-      end
-      
-      # Determine whether to use the timestamp or the numerator and denominator.
-      if numerator && (
-        !timestamp || 
-        (timestamp < 0 && !RubyCoreSupport.time_supports_negative) || 
-        ((timestamp < -2147483648 || timestamp > 2147483647) && !RubyCoreSupport.time_supports_64bit)
-        )
-        
-        @numerator_or_time = numerator
-        @denominator = denominator
-      else
-        @numerator_or_time = timestamp
-        @denominator = nil
-      end
-      
-      @at = nil
-    end
-    
-    # A TimeOrDateTime instance representing the UTC time when this transition
-    # occurs.
-    def at
-      # Thread-safety: It is possible that the value of @at may be calculated
-      # multiple times in concurrently executing threads. It is not worth the
-      # overhead of locking to ensure that @at is only calculated once.
-      
-      unless @at
-        result = unless @denominator
-          TimeOrDateTime.new(@numerator_or_time)
-        else
-          r = RubyCoreSupport.rational_new!(@numerator_or_time, @denominator)
-          dt = RubyCoreSupport.datetime_new!(r, 0, Date::ITALY)
-          TimeOrDateTime.new(dt)
-        end
-
-        return result if frozen?
-        @at = result
-      end
-      
-      @at
-    end
-    
-    # Returns true if this TimezoneTransitionDefinition is equal to the given
-    # TimezoneTransitionDefinition. Two TimezoneTransitionDefinition instances 
-    # are considered to be equal by eql? if offset, previous_offset, 
-    # numerator_or_time and denominator are all equal.
-    def eql?(tti)
-      tti.kind_of?(TimezoneTransitionDefinition) &&
-        offset == tti.offset && previous_offset == tti.previous_offset &&
-        numerator_or_time == tti.numerator_or_time && denominator == tti.denominator        
-    end
-    
-    # Returns a hash of this TimezoneTransitionDefinition instance.
-    def hash
-      @offset.hash ^ @previous_offset.hash ^ @numerator_or_time.hash ^ @denominator.hash
-    end
-  end
-end