Contents

# -*- encoding: utf-8 -*-

require 'date'

# Date extensions

class Date

  # Return true if the date is a weekday: Mon, Tue, Wed, Thu, Fri
  #
  # ==Example
  #   d = Date.parse('2008-01-01')
  #   d.wday => 2
  #   d.weekday? => true
  
  def weekday?
    wday>0 and wday<6
  end


  # Return true if the date is a weekend: Sat, Sun
  #
  # ==Example
  #   d = Date.parse('2008-01-05')
  #   d.wday => 6
  #   d.weekend? => true

  def weekend?
    wday==0 or wday==6
  end


  # Return a random date between min & max
  #
  # ==Example
  #   d1= Date.parse('2008-01-01')
  #   d2= Date.parse('2009-01-01')
  #   Date.between(d1,d3) => Date 2008-11-22

  def self.between(min,max)
    min+rand(max-min)
  end


  # Return date in a sql format: YYYY-MM-DD
  #
  # ==Example
  #   d=Date.today
  #   d.to_sql => "2007-12-31"

  def to_sql
    return sprintf("%04d-%02d-%02d",year,month,mday)
  end


  # Return the age in years for a given date.
  #
  # ==Example
  #
  #   birthdate=Date.new(1980,10,31)
  #   birthdate.age_years => 28 (where 28 is the correct age for today)
  #
  # ==Example of custom dates
  #
  #   birthdate=Date.new(1980,10,31)
  #
  #   valentines = Date.new(2008,02,14)
  #   birthdate.age_years(valentines) => 27  # before the birthday
  #
  #   halloween = Date.new(2008,10,31)
  #   birthdate.age_years(halloween) => 28   # on the birthday
  #
  #   new_years_eve = Date.new(2008,12,31)
  #   birthdate.age_years(new_years_eve) => 28  # after the birthday

  def age_years(compare_date=Date.today)
    (compare_date.is_a? Date) or raise ArgumentError, "compare_date must be a date"
    age=compare_date.year-year
    compare_month = compare_date.month
    age-=1 if compare_month < month or (compare_month==month and compare_date.day < day)
    age
  end


  # Return the age in days for a given date.

  def age_days(compare_date=Date.today)
    (compare_date.is_a? Date) or raise ArgumentError, "compare_date must be a date"
    (compare_date-self).to_i
  end


end

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
webget_ruby_ramp-1.8.0	lib/webget_ruby_ramp/date.rb
webget_ruby_ramp-1.7.8	lib/webget_ruby_ramp/date.rb
webget_ruby_ramp-1.7.7	lib/webget_ruby_ramp/date.rb
webget_ruby_ramp-1.7.6	lib/webget_ruby_ramp/date.rb
webget_ruby_ramp-1.7.5	lib/webget_ruby_ramp/date.rb