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-US. 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 <harleypig@gmail.com>

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.