date_utils 0.1.2 → 0.1.3

data/lib/date_utils.rb

@@ -11,14 +11,39 @@
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
-#
+# 
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 # 
+
 require 'date'
 
+# DateUils 
+# is a simple Collection of classes which offer some 
+# handy tools to get a grip on 'Date'
+# ----
+# * DateUtils::Year
+# * DateUtils::Month
+# * DateUtils::Week
+# 
 module DateUtils
+  
+  # common to Year/Month/Week
+  # 
+  module Common
+    
+    def include?(date)
+      if date.instance_of?(Date)
+        self.respond_to?('days') && self.days.include?(date)
+      else
+        raise ArgumentError, "need Date as input or no instance variable 'days'..."
+      end
+    end
+    
+    
+  end
+  
   # represents a timezone
   # 
   class GMTZone
@@ -43,7 +68,8 @@ module DateUtils
   # ending on Sundays
   #  
   class Week
-  
+    include Common
+    
     # the first day (Monday) of the week
     attr_reader :first_day 
     
@@ -59,20 +85,24 @@ module DateUtils
     # the Month of the week
     attr_reader :month
       
-    # create a new Week-instance with the given initial Date
+    # create a new Week-instance with the given initial Date or Week-number
     # if 'date' is nil, create an instance with Date.today
     # 
     def initialize(date=nil)
-      date = Date.today if date.nil?
-      if date.kind_of?(Date)
-        @month = Month.new(date)
-        @date = date
-        @num_week = date.cweek
-        @first_day = date - ( date.cwday - 1 )
-        @last_day = date + ( 7 - date.cwday ) 
+      if date.nil?
+        _date = Date.today
+      elsif date.kind_of?(Date)
+        _date = date
+      elsif date.kind_of?(Fixnum)
+        _date = Year.new.get_week(date).date
       else
-        raise ArgumentError, "needs Date object as input."
+        raise ArgumentError, "needs Date object or Fixnum for Week as input."
       end
+      @month = Month.new(_date)
+      @date = _date
+      @num_week = _date.cweek
+      @first_day = _date - ( _date.cwday - 1 )
+      @last_day = _date + ( 7 - _date.cwday ) 
     end
     
     # return new Week -instance one week after self
@@ -100,6 +130,8 @@ module DateUtils
   # Represents a 'Month'
   #  
   class Month
+    include Common
+    
     # the initial / regular Date instance  
     attr_reader :date
       
@@ -157,6 +189,8 @@ module DateUtils
   # represents a Year
   # 
   class Year
+    include Common
+    
     # the initial Date of the Year -instance 
     attr_reader :date
     
@@ -197,5 +231,12 @@ module DateUtils
       end
       arr
     end
+    
+    # returns Week 'num' of self
+    #
+    def get_week(num)
+      ! num.kind_of?(Fixnum) || num > 52 ? ArgumentError.new("invalid week-number 'num'"): self.weeks[num -1]
+    end
+    
   end
 end

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: date_utils
 version: !ruby/object:Gem::Version 
-  version: 0.1.2
-date: 2007-03-01 00:00:00 +01:00
+  version: 0.1.3
+date: 2007-03-02 00:00:00 +01:00
 summary: Some handy utils to deal with Date
 require_paths: 
 - lib