date_utils 0.1.1

data/README

@@ -0,0 +1,23 @@
+# == Synopsis
+# Some handy Year, Month, Week objects to make live with Date easier.
+#
+# == Author
+# Rene Paulokat
+# 
+# == Copyright
+# Copyright (c) 2007 Rene Paulokat
+# 
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# 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
+#

data/lib/date_utils.rb

@@ -0,0 +1,195 @@
+# this Module prepares some handy objects to
+# deal with Date 's
+#--
+# Copyright (c) 2007 Rene Paulokat
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# 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
+# 
+module DateUtils
+  # represents a timezone
+  # 
+  class GMTZone
+  
+    # collection of String each representing a timezone
+    # 
+    def GMTZone.offsets
+      arr = []
+      (-12..13).each do |i|
+        if i.to_s.include?('-') 
+          i.to_s.length == 2 ? arr.push("GMT -0" + i.to_s.split('-')[-1].to_s + ":00") : arr.push("GMT " + i.to_s + ":00")
+        else
+          i.to_s.length == 1 ? arr.push("GMT +0" + i.to_s + ":00") : arr.push("GMT +" + i.to_s + ":00")
+        end
+      end
+      arr
+    end
+
+  end
+    
+  # Represents a 'Week' beginning on Mondays and 
+  # ending on Sundays
+  #  
+  class Week
+  
+    # the first day (Monday) of the week
+    attr_reader :first_day 
+    
+    # the last day (Sunday) of the week
+    attr_reader :last_day 
+      
+    # the num of the week
+    attr_reader :num_week
+      
+    # the initial / regular Date instance  
+    attr_reader :date
+      
+    # the Month of the week
+    attr_reader :month
+      
+    # create a new Week-instance with the given initial Date
+    # 
+    def initialize(date)
+      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 ) 
+      else
+        raise ArgumentError, "needs Date object as input."
+      end
+    end
+    
+    # return new Week -instance one week after self
+    # 
+    def next
+      return Week.new(@last_day + 1)
+    end
+    
+    # returns new Week -instance one week before self
+    # 
+    def previous
+      return Week.new(@first_day - 1)
+    end
+    
+    # returns collection of days as Date -instances
+    # 
+    def days
+      arr = []
+      @first_day.upto(@last_day) { |date| arr << date }
+      arr
+    end
+    
+  end
+    
+  # Represents a 'Month'
+  #  
+  class Month
+    # the initial / regular Date instance  
+    attr_reader :date
+      
+    # the first day of the Month -instance
+    attr_reader :first_day
+      
+    # the last day of the Month -instance
+    attr_reader :last_day
+    
+    # the Month -number
+    attr_reader :month
+      
+    # the number of days in Month
+    attr_reader :num_days
+      
+    # create a new Month of given Date
+    # 
+    def initialize(date)
+      if date.kind_of?(Date)
+        @date = date
+        @month = date.month
+        @first_day = date.mday > 1 ? (date - ( date.mday - 1)) : date 
+        @num_days = 31 if [1,3,5,7,8,10,12].include?(@month)
+        @num_days = 30 if [4,6,9,11].include?(@month)
+        ( date.leap? ? (@num_days = 29) : (@num_days = 28) ) if @month == 2
+        @last_day = @first_day + ( @num_days - 1 )
+      else
+        raise ArgumentError, "needs Date object as input!"
+      end
+      
+      # returns new Month -instance one Month later than self
+      # 
+      def next
+        return Month.new(@last_day + 1)
+      end
+      
+      # returns a new Month -instance one Month prior to self
+      # 
+      def previous
+        return Month.new((@first_day - 1).to_date)
+      end
+        
+      # returns collection of days as Date -instances of self
+      #  
+      def days
+        arr = []
+        @first_day.upto(@last_day) { |date| arr << date }
+        arr
+      end
+        
+    end
+  end
+    
+  # represents a Year
+  # 
+  class Year
+    # the initial Date of the Year -instance 
+    attr_reader :date
+    
+    # the Year as an Integer of self
+    attr_reader :year
+    
+    # create a new Year -instance with given Date
+    # 
+    def initialize(date)
+      unless date.kind_of?(Date)
+        raise ArgumentError, "needs Date as input!"
+      end
+      @year = date.year
+    end
+    
+    # returns collection of Month -instances of self
+    # 
+    def months
+      arr = []
+      for i in 1..12
+        arr.push( Month.new(Date.civil(@year,i) ) )
+      end
+      arr
+    end
+    
+    # returns collection of Week -instances of self
+    # neccessarily overlaps year boundarys
+    # 
+    def weeks
+      d = Date.civil(@year)
+      arr = []
+      week = Week.new(d)
+      arr.push(week)
+      for i in 1..52
+        week = week.next
+        arr.push(week)
+      end
+      arr
+    end
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.2
+specification_version: 1
+name: date_utils
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+date: 2007-02-28 00:00:00 +01:00
+summary: Some handy utils to deal with Date
+require_paths: 
+- lib
+email: rene@so36.net
+homepage: http://rcms.oopen.de
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Rene Paulokat
+files: 
+- lib/date_utils.rb
+- README
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+