Contents

#
# Time math is handled slightly differently.  The difference is considered to be an exact duration if
# the subtracted value is in hours, minutes, or seconds.  It is rounded to the nearest day if the offset
# is in years, decades, or centuries.  This leads to less precise values, but ones that match the 
# calendar better.
class Time
  
  class << self
    alias unit_time_at at
  end
  
  # Convert a duration to a Time value by considering the duration to be the number of seconds since the 
  # epoch
  # @param [Time] arg
  # @param [Integer] ms
  # @return [Unit, Time]
  def self.at(arg,ms=0)
    case arg
    when Unit
      unit_time_at(arg.convert_to("s").scalar, ms)
    else
      unit_time_at(arg, ms)
    end
  end
  
  # @return (see Unit#initialize)
  def to_unit(other = nil)
    other ? Unit.new(self).convert_to(other) : Unit.new(self)
  end
  alias :unit :to_unit
  alias :u :to_unit
  
  unless Time.instance_methods.include?(:to_date)
    # :nocov_19:
    # @return [Date]
    def to_date
      x=(Date.civil(1970,1,1)+((self.to_f+self.gmt_offset)/86400.0)-0.5)
      Date.civil(x.year, x.month, x.day)
    end
    # :nocov_19:
  end
  
  alias :unit_add :+
  # @return [Unit, Time]
  def +(other)
    case other
    when Unit
      other = other.convert_to('d').round.convert_to('s') if ['y', 'decade', 'century'].include? other.units  
      begin
        unit_add(other.convert_to('s').scalar)
      rescue RangeError
        self.to_datetime + other
      end
    else
      unit_add(other)
    end
  end
  
  # @example
  #  Time.in '5 min'
  # @return (see Time#+)
  def self.in(duration)
    Time.now + duration.to_unit
  end
  
  alias :unit_sub :-
  
  # @return [Unit, Time]
  def -(other)
    case other
    when Unit
      other = other.convert_to('d').round.convert_to('s') if ['y', 'decade', 'century'].include? other.units  
      begin
        unit_sub(other.convert_to('s').scalar)
      rescue RangeError
        self.send(:to_datetime) - other
      end
    else
      unit_sub(other)
    end
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
ruby-units-1.4.2	lib/ruby_units/time.rb
ruby-units-1.4.1	lib/ruby_units/time.rb