A collection of Ruby methods to deal with statutory and other holidays. You deserve a holiday!
Go to file
Alex Dunae cf000b1df2
2007-11-24 23:22:10 +00:00
bin 2007-11-24 23:22:10 +00:00
data 2007-11-24 23:22:10 +00:00
lib 2007-11-24 23:22:10 +00:00
test 2007-11-24 23:22:10 +00:00
CUSTOM DATES Type in CUSTOM DATES 2007-11-23 21:13:00 +00:00
LICENSE Added LICENSE and REFERENCES 2007-11-20 19:54:55 +00:00
rakefile.rb 2007-11-24 23:22:10 +00:00
README 2007-11-24 23:22:10 +00:00
REFERENCES Added basic mixin infrastructure 2007-11-21 21:08:34 +00:00

= Ruby Holidays Gem
  
A set of classes to deal with holidays in Ruby.

Extends Ruby's built-in Date class and supports custom holiday definition lists.

=== Examples

==== Using the Holidays class
  # Get all holidays on April 25, 2008 in Australia
  date = Date.civil(2008,4,25)
  Holidays.by_day(date, :au)
  => [{:name => 'ANZAC Day',...}]


  # Get all holidays in July, 2008 in Canada and the US
  from = Date.civil(2008,7,1)
  to   = Date.civil(2008,7,31)
  Holidays.between(from, to, [:ca,:us])
  => [{:name => 'Canada Day',...}
      {:name => 'Idenpendence Day',...}]


==== Extending Ruby's Date class
  # Lookup Canada Day in the :ca region
  Date.civil(2008,7,1).holiday?(:ca)
  => true
  
  # Lookup Canada Day in the :fr region
  Date.civil(2008,7,1).holiday?(:fr)
  => false

=== Installation

To install the gem from RubyForge:

  gem install holidays

Or, download the source <tt>.tgz</tt> file from http://rubyforge.org/holidays/ and 
extract it somewhere in your include path.

=== Credits and code

* Project page: http://code.dunae.ca/holidays
* Source: http://code.dunae.ca/svn/holidays
* Docs: http://code.dunae.ca/holidays/doc

By Alex Dunae (dunae.ca, e-mail 'code' at the same domain), 2007.

Made on Vancouver Island.