Date::Holidays::AU - Determine Australian Public Holidays


Date-Holidays-AU documentation  | view source Contained in the Date-Holidays-AU distribution.

Index


NAME

Top

Date::Holidays::AU - Determine Australian Public Holidays

SYNOPSIS

Top

  use Date::Holidays::AU qw( is_holiday );
  my ($year, $month, $day) = (localtime)[ 5, 4, 3 ];
  $year  += 1900;
  $month += 1;
  my ($state) = 'VIC';
  print "Excellent\n" if is_holiday( $year, $month, $day, $state );

DESCRIPTION

Top

This module makes an attempt at describing Australian holidays using the interface defined Date::Holidays::Abstract, which defines two methods, is_holiday and holidays.

Functions

Top

returns true or false depending to whether or not the date in question is a holiday according to the state and the additional parameters.

Returns a hashref of all defined holidays in the year according to the state and the additional parameters. Keys in the hashref are in 'mmdd' format, the values are the names of the holidays.

The states may be 'VIC','WA','NT','QLD','TAS','NSW','SA' or 'ACT'. The default state is 'VIC'. The following tables lists the allowable parameters for each state;

   State  Parameter             Default   Values
   VIC    no_melbourne_cup	0         1 | 0
   NT     region		'Darwin'  'Alice Springs' | 'Tennant Creek' | 'Katherine' | 'Darwin' | 'Borrolooda'
   QLD    no_show_day		0         1 | 0
   NSW    include_bank_holiday	0         1 | 0
   ACT    include_bank_holiday	0         1 | 0
   TAS    holidays              []        'Devonport Cup','King Island Show','Launceston Cup','Hobart Show','Recreation Day','Burnie Show','Agfest','Launceston Show','Flinders Island Show'

AUTHOR

Top

David Dick <ddick@cpan.org>

PREREQUISITES

Top

Uses Date::Easter for easter calculations. Makes use of the Time::Local modules from the standard Perl distribution.

BUGS

Top

Support for WA's Queen's Birthday holiday only consists of hard-coded values. Further investigation is needed. Therefore WA is not supported after 2012.

COPYRIGHT

Top

SEE ALSO

Top

Date::Holidays::Abstract, Date::Holiday::DE, Date::Holiday::UK


Date-Holidays-AU documentation  | view source Contained in the Date-Holidays-AU distribution.