NAME
   DateTime::Event::Holiday::US

VERSION
   version 0.02

SYNOPSIS
   # This module handles creating a DateTime::Set::ICal object (see #
   DateTime::Event::Recurrence) that you can use as a US holiday.

     use DateTime::Event::Holiday::US;

     my $thanksgiving = DateTime::Event::Holiday::US::holiday( 'Thanksgiving' );
     my @holidays = DateTime::Event::Holiday::US::known();

   # $thanksgiving will be a DateTime::Set::ICal object that you can
   perform # anything you would do with a DateTime::Set object.

   # $holidays will be an array of all holiday names
   DateTime::Event::Holiday::US # knows about.

NAME
   DateTime::Event::Holiday::US - US Holiday's as DateTime::Set objects

VERSION
   Version 0.02

EXPORT
   Nothing is exported.

SUBROUTINES/METHODS
 known
   Returns a list of holiday names DateTime::Event::Holiday::US knows
   about.

     @known = DateTime::Event::Holiday::US::known();

 holiday
   Returns the requested holiday as a DateTime::Set::ICal object.

     $thanksgiving = DateTime::Event::Holiday::US::holiday( 'Thanksgiving' );

   $thanksgiving will be a DateTime::Set::ICal object that you can perform
   anything you would do with a DateTime::Set object.

 holidays
   Returns a hash reference of DateTime::Set::ICal objects for each
   holiday.

     $holidays = DateTime::Event::Holiday::US::holidays( 'Thanksgiving', 'Black Friday' );

   $holidays is a hash reference where the key is the name of the holiday
   and the value is the object.

 holidays_as_set
   Returns requested holidays as a single DateTime::Set object;

     $holidays = DateTime::Event::Holiday::US::holidays_as_set( 'Thanksgiving', 'Black Friday' );

   $holidays would be a DateTime::Set containing sets for both Thanksgiving
   and Black Friday

AUTHOR
   Alan Young, "<alansyoungiii at gmail.com>"

BUGS
   Please report any bugs or feature requests to
   "bug-datetime-event-holiday-us at rt.cpan.org", or through the web
   interface at
   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DateTime-Event-Holiday-U
   S>. I will be notified, and then you'll automatically be notified of
   progress on your bug as I make changes.

SUPPORT
   You can find documentation for this module with the perldoc command.

       perldoc DateTime::Event::Holiday::US

   You can also look for information at:

   *   RT: CPAN's request tracker

       <http://rt.cpan.org/NoAuth/Bugs.html?Dist=DateTime-Event-Holiday-US>

   *   AnnoCPAN: Annotated CPAN documentation

       <http://annocpan.org/dist/DateTime-Event-Holiday-US>

   *   CPAN Ratings

       <http://cpanratings.perl.org/d/DateTime-Event-Holiday-US>

   *   Search CPAN

       <http://search.cpan.org/dist/DateTime-Event-Holiday-US/>

ACKNOWLEDGEMENTS
LICENSE AND COPYRIGHT
   Copyright 2010 Alan Young.

   This program is free software; you can redistribute it and/or modify it
   under the terms of either: the GNU General Public License as published
   by the Free Software Foundation; or the Artistic License.

   See http://dev.perl.org/licenses/ for more information.

INSTALLATION
   See perlmodinstall for information and options on installing Perl
   modules.

AUTHOR
   Alan Young <[email protected]>

COPYRIGHT AND LICENSE
   This software is copyright (c) 2010 by Alan Young.

   This is free software; you can redistribute it and/or modify it under
   the same terms as the Perl 5 programming language system itself.