NAME

Date::Holidays::FR - Determine French holidays

SYNOPSIS

  use Date::Holidays::FR;
  my ($year, $month, $day) = (localtime)[5, 4, 3];
  $year  += 1900;
  $month +=    1;
  print "Woohoo" if is_fr_holiday($year, $month, $day);

  my ($month, $day) = get_easter($year);
  my ($month, $day) = get_ascension($year);
  my ($month, $day) = get_pentecost($year);

DESCRIPTION

is_fr_holiday method return true value when the day is holiday.

There are 11 holidays in France:

  • 1er janvier : Nouvel an

  • Lundi de Pâques

  • 1er mai : Fête du travail

  • 8 mai : Armistice 1939-1945

  • Ascension

  • Lundi de Pentecôte

  • 14 juillet : Fête nationale

  • 15 août : Assomption

  • 1er novembre : Toussaint

  • 11 novembre : Armistice 1914-1918

  • 25 décembre : Noël

Easter is computed with Date::Easter module.

Ascension is 39 days after Easter.

Pentecost monday is 50 days after Easter.

SUBROUTINES

is_fr_holiday($year, $month, $day)

Returns the name of the holiday in french that falls on the given day, or undef if there is none.

get_easter($year)

Returns the month and day of easter day for the given year.

get_ascension($year)

Returns the month and day of ascension day for the given year.

get_pentecost($year)

Returns the month and day of pentecost day for the given year.

SUPPORT

Please report any requests, suggestions or bugs via the RT bug-tracking system at https://rt.cpan.org/ or email to bug-Date-Holidays-FR\@rt.cpan.org.

https://rt.cpan.org/NoAuth/Bugs.html?Dist=Date-Holidays-FR is the RT queue for Date::Holidays::FR. Please check to see if your bug has already been reported.

Or you can go to https://github.com/jforget/Date-Holidays-FR, and submit a pull request.

AUTHORS

Module creator: Fabien Potencier

Current maintainer: Jean Forget (JFORGET at cpan dot org)

LICENSE

Copyright © 2004, 2019 Fabien Potencier and Jean Forget. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself: GNU Public License version 1 or later and Perl Artistic License.

The full text of the license can be found in the LICENSE file included with this module or at https://dev.perl.org/licenses/artistic.html and https://www.gnu.org/licenses/gpl-1.0.html.

Here is the summary of GPL:

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see <https://www.gnu.org/licenses/> or write to the Free Software Foundation, Inc., https://fsf.org.

SEE ALSO

perl(1), Date::Holidays::UK, Date::Holidays::DE.