NAME

Date::Holidays::USExtended - Provides an extended set of United States holidays

VERSION

version 0.0300

SYNOPSIS

# Using with the Date::Holidays module:
use Date::Holidays ();
my $dh = Date::Holidays->new(countrycode => 'USExtended', nocheck => 1);
print $dh->is_holiday(year => 2024, month => 1, day => 1), "\n";
my $h = $dh->holidays;

# Using the Date::Holidays::USExtended module directly:
use Date::Holidays::USExtended ();
$dh = Date::Holidays::USExtended->new;
print $dh->is_holiday(2024, 1, 1), "\n";
$h = $dh->holidays;
$h = $dh->us_holidays(2032);

DESCRIPTION

Date::Holidays::USExtended provides an extended set of United States holidays.

METHODS

new

$dh = Date::Holidays::USExtended->new;

Return a new Date::Holidays::USExtended object.

is_holiday

$holiday = $dh->is_holiday($year, $month, $day);

Takes three arguments:

year:  four digits
month: between 1-12
day:   between 1-31

Returns the name of the holiday, if one exists on that day.

us_holidays

$holidays = $dh->us_holidays;
$holidays = $dh->us_holidays($year);

Returns a hash reference of holiday names, where the keys are by month and day.

holidays

$holidays = $dh->holidays;
$holidays = $dh->holidays($year);

Returns a hash reference of holiday names, where the keys are 4 digit strings month and day.

SEE ALSO

Date::Holidays

Date::Holidays::Adapter

Date::Holidays::Adapter::USA

AUTHOR

Gene Boggs <gene.boggs@gmail.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2024 by Gene Boggs.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)