Holiday
Holiday is a gem that lets you configure holidays for multiple countries with YAML.
Default Usage
First setup path to a YAML file and set the country code.
Holiday.yaml_file = "/path/to/yaml/holiday.yml"
Holiday.country = "US"
You can query for dates
Holiday.find("christmas")
Holiday.find("labour day")
Or supply a year
Holiday.find(:christmas, 2005)
Holiday.find(:thanksgiving, 1999)
YAML
The YAML format for Holiday is as follows
holiday:
US:
christmas:
when: december 25th
as: christmas
halloween:
when: october 31st
as: halloween, all hallows eve
labor_day:
when: 1st monday in september
as: labor day, labour day
thanksgiving:
when: 4th thursday in november
as: thanksgiving, turkey day
Holidays are scoped by country code. Each holiday needs both "when" and "as" keys. The "when" key can either be an exact
month and day, or the occurrence of the holiday in the given month. E.g., "1st monday in september".
The "as" key is used to identify holidays by alternate names and spellings. For instance, "thanksgiving" and "turkey day" should both
point to the 4th thursday in november.
Holiday.find("turkey day")
Holiday.find(:thanksgiving)
Other methods
There are a few other methods that may be useful
Holiday.all
Holiday.scan("a string containing a holiday by name, like christmas")
Holiday::Query.find("all hallows eve")