Alan Young > DateTime-Event-Holiday-US > DateTime::Event::Holiday::US

Download:
DateTime-Event-Holiday-US-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  

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:

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.

syntax highlighting: