DateTime::Calendar::FrenchRevolutionary::Locale::en -- English localization for the French revolutionary calendar.
use DateTime::Calendar::FrenchRevolutionary::Locale; my $english_locale = DateTime::Calendar::FrenchRevolutionary::Locale->load('en'); my $english_month_name =$english_locale->month_name($date);
This module provides localization for DateTime::Calendar::FrenchRevolutionary. Usually, its methods will be invoked only from DT::C::FR.
The month names come from Thomas Carlyle's book. Most of the feast names come from Alan Taylor's kokogiak.com web site, later checked with Wikipedia and with Jonathan Badger's French Revolutionary Calendar module written in Ruby. The day names are from this module's author.
This module provides the following class methods:
new
Returns an object instance, which is just a convenient value to be stored in a variable.
Contrary to the widely used Gregorian calendar, there is no need to customize a French Revolutionary calendar locale. Therefore, there are no instance data and no instance methods.
month_name ($date)
Returns an English translation for $date's month, where $date is a DateTime::Calendar::FrenchRevolutionary object.
$date
DateTime::Calendar::FrenchRevolutionary
month_abbreviation ($date)
Returns a 3-letter abbreviation for the English month name.
day_name ($date)
Returns an English translation for the day name.
day_abbreviation ($date)
Returns a 3-letter abbreviation for the English day name.
feast_short ($date)
Hopefully returns an adequate English translation for the plant, animal or tool that correspond to $date's feast.
Note: in some cases, the feast French name is left untranslated, while in some other cases, the translation is inadequate. If you are fluent in both French and English, do not hesitate to send corrections to the author.
feast_long ($date)
Same as feast_short, with a "day" suffix, as in the current calendar's "groundhog day" or "Colombus day".
feast_short
feast_caps ($date)
Same as feast_long with capitalized first letters.
feast_long
on_date ($date)
Gives a small text about the events which occurred the same month and day as $date between the calendar's epoch (22 Sep 1792) and the day it was rescinded (31 Dec 1805).
Most of these events come from an anonymous propaganda book published in year VIII (1799--1800). The others are common knowledge available in any French History book or any encyclopedia.
Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for more details.
Jean Forget <JFORGET@cpan.org>
The development of this module is hosted by Les Mongueurs de Perl, http://www.mongueurs.net/.
The French Revolution, Thomas Carlyle, Oxford University Press
Calendrier Militaire, anonymous
http://datetime.perl.org/
http://www.kokogiak.com/frc/default.asp (the link still exists, but it seems to no longer include stuff about the French Revolutionary calendar.)
https://github.com/jhbadger/FrenchRevCal-ruby
http://en.wikipedia.org/wiki/French_Republican_Calendar
Copyright (c) 2003, 2004, 2010, 2011, 2012 Jean Forget. All rights reserved. This program is free software. You can distribute, modify, and otherwise mangle DateTime::Calendar::FrenchRevolutionary under the same terms as perl 5.12.2.
To install DateTime::Calendar::FrenchRevolutionary, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DateTime::Calendar::FrenchRevolutionary
CPAN shell
perl -MCPAN -e shell install DateTime::Calendar::FrenchRevolutionary
For more information on module installation, please visit the detailed CPAN module installation guide.