- HISTORICAL NOTES
- SEE ALSO
- LICENSE STUFF
DateTime::Calendar::FrenchRevolutionary - Dates in the French Revolutionary Calendar
use DateTime::Calendar::FrenchRevolutionary; # Use the date "18 Brumaire VIII" (Brumaire being the second month) $dt = DateTime::Calendar::FrenchRevolutionary->new( year => 8, month => 2, day => 18, ); # convert from French Revolutionary to Gregorian... $dtgreg = DateTime->from_object( object => $dt ); # ... and back again $dtrev = DateTime::Calendar::FrenchRevolutionary->from_object( object => $dtgreg );
DateTime::Calendar::FrenchRevolutionary implements the French Revolutionary Calendar. This module implements most methods of DateTime; see the DateTime(3) manpage for all methods.
The documentation uses the word décade (the first "e" having an acute accent). This French word is not the translation of the English word "decade" (ten-year period). It means a ten-day period.
For your information, the French word for a ten-year period is décennie.
The Revolutionary calendar was in use in France from 24 November 1793 (4 Frimaire II) to 31 December 1805 (10 Nivôse XIV). An attempt to apply the decimal rule (the basis of the metric system) to the calendar. Therefore, the week disappeared, replaced by the décade. In addition, all months have exactly 3 decades, no more, no less.
At first, the year was beginning on the equinox of autumn, for two reasons. First, the republic had been established on 22 September 1792, which happened to be the equinox, and second, the equinox was the symbol of equality, the day and the night lasting exactly 12 hours each. It was therefore in tune with the republic's motto "Liberty, Equality, Fraternity". But it was not practical, so Romme proposed a leap year rule similar to the Gregorian calendar rule.
In his book The French Revolution, the XIXth century writer Thomas Carlyle proposes these translations for the month names:
- Vendémiaire -> Vintagearious
- Brumaire -> Fogarious
- Frimaire -> Frostarious
- Nivôse -> Snowous
- Pluviôse -> Rainous
- Ventôse -> Windous
- Germinal -> Buddal
- Floréal -> Floweral
- Prairial -> Meadowal
- Messidor -> Reapidor
- Thermidor -> Heatidor
- Fructidor -> Fruitidor
Each month has a duration of 30 days. Since a year lasts 365.25 days (or so), five additional days (or six on leap years) are added after Fructidor. These days are called Sans-Culottides. For programming purposes, they are considered as a 13th month (much shorter than the 12 others).
There was also an attempt to decimalize the day's subunits, with 1 day = 10 hours, 1 hour = 100 minutes and 1 minute = 100 seconds. But this reform was put on hold after two years or so and it never reappeared.
Other reforms to decimalize the time has been proposed during the last part of the XIXth Century, but these reforms were not applied too. And they are irrelevant for this French Revolutionary calendar module.
Since the week has been replaced by the décade, the corresponding method names still are
day_of_decade, etc. English speakers, please note that this has nothing to do with a 10-year period.
The module supports both Anglo-Babylonian time (24x60x60) and decimal time. The accessors for ABT are
abt_hms, the accessors for decimal time are
iso8601 methods use only decimal time. The ABT accessors are provided to be historically correct, since the decimal time reform was never put in force. Yet, emphasis is on decimal time because it is more fun than sexagesimal time, which anyhow can be obtained with the standard Gregorian
Creates a new date object. This class accepts the following parameters:
Year number, mandatory. Year 1 corresponds to Gregorian years late 1792 and early 1793.
Month number, in the range 1..12, plus number 13 to designate the end-of-year additional days.
Day number, in the range 1..30. In the case of additional days, the range is 1..5 or 1..6 depending on the year (leap year or normal).
Decimal hour number, decimal minute number and decimal second number. The hour is in the 0..9 range, both other parameters are in the 0..99 range. These parameters cannot be specified with the sexagesimal time parameters
abt_xxx (see below).
Sexagesimal hour number, sexagesimal minute number and sexagesimal second number. The hour is in the 0..23 range, both other parameters are in the 0..59 range. These parameters cannot be specified with the decimal time parameters (see above).
Only the values
en(English) are allowed. Default is French. No other values are possible, even territory variants such as
from_epoch( epoch => $epoch )
Creates a date object from a timestamp value. This timestamp is the number of seconds since the computer epoch, not the calendar epoch.
Creates a date object that corresponds to the precise instant the method is called.
from_object( object => $object, ... )
Creates a date object by converting another object from the DateTime suite. The preferred way for calendar to calendar conversion.
last_day_of_month( ... )
new, except that the
dayparameter is forbidden and is automatically set to the end of the month. If the
monthparameter is 13 for the additional days, the day is set to the end of the year, either the 5th or the 6th additional day.
Creates a replica of the original date object.
set( .. )
This method can be used to change the local components of a date time, or its locale. This method accepts any parameter allowed by the
This method performs parameters validation just as is done in the
Returns the year.
Returns the month in the 1..12 range. If the date is an additional day at the end of the year, returns 13, which is not really a month number.
Returns the month in the 0..11 range. If the date is an additional day at the end of the year, returns 12, which is not really a month number.
Returns the French name of the month or its English translation. No other language is supported yet. For the additional days at the end of the year, returns "jour complémentaire", the translation of "additional day".
Note: The English translations for the month names come from Thomas Carlyle's book.
Returns a 3-letter abbreviation of the month name. For the additional days at the end of the year, returns "S-C", because these additional days were also known as the Sans-culottides.
day_of_month, day, mday
Returns the day of the month, from 1..30.
day_of_decade, dod, day_of_week, dow, wday
Returns the day of the decade, from 1..10. The
day_of_weeknames are there for compatibility's sake with
DateTime, even if the word "week" is improper.
Returns the name of the current day of the décade.
Returns the abbreviated name of the current day of the décade.
Returns the day of the year.
feast, feast_short, feast_long, feast_caps
Returns the plant, animal, mineral or tool associated with the day. The default format is
short. If requested, you can ask for the
longformat, with a
jour de...prefix, or the
capsformat, with the first letter of the prefix and feast capitalized. Example: for 11 Vendémiaire, we have:
feast, feast_short pomme de terre feast_long jour de la pomme de terre feast_caps Jour de la Pomme de terre
Note: the English translation for the feasts comes mainly from Alan Taylor's website "Preserving the French Republican Calendar".
ymd, dmy, mdy
Returns the date in the corresponding composite format. An optional parameter allows you to choose the separator between the date elements.
abt_hour, abt_minute, abt_min, abt_second, abt_sec
Return the corresponding time elements, using a sexagesimal scale. This is also known as the Anglo-Babylonian Time.
hour, minute, min, second, sec
Return the corresponding time elements, using a decimal scale, with 10 hours per day, 100 minutes per hour and 100 seconds per minute.
Returns a composite string with the three time elements. Uses the Anglo-Babylonian Time. An optional parameter allows you to choose the separator (
Returns a composite string with the three time elements. Uses the decimal time. An optional parameter allows you to choose the separator (
Returns the date and time is a format similar to what ISO-8601 has specified for the Gregorian calendar.
Returns a true value if the year is a leap year, false else.
Returns the décade number.
Returns a 2-element list, with the year number and the decade number. Since the décade is always aligned with a month and then with a year, the year element is always the same as the date's year. Anyhow, this is done for compatibility with DateTime's
Returns the current UTC Rata Die days, seconds and nanoseconds as a 3-element list. This exists primarily to allow other calendar modules to create objects based on the values provided by this object.
These return the Julian Day and Modified Julian Day, respectively. The value returned is a floating point number. The fractional portion of the number represents the time portion of the datetime.
Returns the current UTC Rata Die days and seconds purely as seconds. This is useful when you need a single number to represent a date.
Returns the current local Rata Die days and seconds purely as seconds.
strftime( $format, ... )
This method implements functionality similar to the
strftime()method in C. However, if given multiple format strings, then it will return multiple elements, one for each format string.
See the strftime Specifiers section for a list of all possible format specifiers.
Return the UTC epoch value for the datetime object. Internally, this is implemented
DateTime, which in turn calls
Time::Local, which uses the Unix epoch even on machines with a different epoch (such as Mac OS). Datetimes before the start of the epoch will be returned as a negative number.
Since epoch times cannot represent many dates on most platforms, this method may simply return undef in some cases.
Using your system's epoch time may be error-prone, since epoch times have such a limited range on 32-bit machines. Additionally, the fact that different operating systems have different epoch beginnings is another source of bugs.
Gives a few historical events that took place on the same date (day+month, irrespective of the year). These events occur during the period of use of the calendar, that is, no later than Gregorian year 1805. The related events either were located in France, or were battles in which a French army was involved.
This method accepts one optional argument, the language. For the moment, only "en" for English and "fr" for French are available. If not given, the method will use the date object's current locale.
Not all eligible events are portrayed there. The events database will be expanded in future versions.
Most military events are extracted from Calendrier Militaire, a book written by an anonymous author in VII (1798) or so. I guess there is no longer any copyright attached. Please note that this is a propaganda book, which therefore gives a very biased view of the events.
The following specifiers are allowed in the format string given to the
The abbreviated day of decade name.
The full day of decade name.
The abbreviated month name, or 'S-C' for additional days (abbreviation of Sans-culottide, another name for these days).
The full month name.
The date-time, using the default format, as defined by the current locale.
The century number (year/100) as a 2-digit integer.
The day of the month as a decimal number (range 01 to 30).
Equivalent to %m/%d/%y. This is not a good standard format if you have want both Americans and Europeans (and others) to understand the date!
Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space.
The month as a decimal number (1 to 13). Unlike %m, a leading zero is replaced by a space.
Equivalent to %Y-%m-%d (the ISO 8601 date format)
Strictly similar to %y, since décades are always aligned with the beginning of the year in this calendar.
Strictly similar to %Y, since décades are always aligned with the beginning of the year in this calendar.
Equivalent to %b.
The hour as a decimal number using a 10-hour clock (range 0 to 9). The result is a single-char string.
The hour as a decimal number using the numbers on a clockface, that is, range 1 to 10. The result is a single-char string, except for 10.
The day of the year as a decimal number (range 001 to 366).
The feast for the day, in long format ("jour de la pomme de terre"). Also available as %*.
The feast for the day, in capitalised long format ("Jour de la Pomme de terre").
The feast for the day, in short format ("pomme de terre").
The hour (10-hour clock) as a decimal number (range 0 to 9); the result is a 2-char string, the digit is preceded by a blank. (See also %H.)
The hour as read from a clockface (range 1 to 10). The result is a 2-char string, the digit is preceded by a blank, except of course for 10. (See also %I.)
The year as a decimal number including the century. Strictly similar to %Y and %G.
The month as a decimal number (range 01 to 13).
The minute as a decimal number (range 00 to 99).
A newline character.
Either `AM' or `PM' according to the given time value, or the corresponding strings for the current locale. Noon is treated as `pm' and midnight as `am'.
Like %p but in lowercase: `am' or `pm' or a corresponding string for the current locale.
The decimal time in a.m. or p.m. notation. In the POSIX locale this is equivalent to `%I:%M:%S %p'.
The decimal time in 10-hour notation (%H:%M). (SU) For a version including the seconds, see %T below.
The number of seconds since the epoch.
The second as a decimal number (range 00 to 99).
A tab character.
The decimal time in 10-hour notation (%H:%M:%S).
The day of the décade as a decimal, range 1 to 10, Primidi being 1 and Décadi being 10. See also %w.
The décade number of the current year as a decimal number, range 01 to 37.
The decade number (French Revolutionary equivalent to the ISO 8601:1988 week number) of the current year as a decimal number, range 01 to 37. Identical to %U, since décades are aligned with the beginning of the year.
The day of the décade as a decimal, range 0 to 9, Décadi being 0. See also %u.
The décade number of the current year as a decimal number, range 00 to 37. Strictly similar to %U and %V.
The year as a decimal number without a century (range 00 to 99).
The year as a decimal number including the century.
The year as a lowercase Roman number.
The year as a uppercase Roman number, which is the traditional way to write years when using the French Revolutionary calendar.
The time-zone as hour offset from UTC. Required to emit RFC822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z"). Since the module does not support time zones, this gives silly results and you cannot be RFC822-conformant. Anyway, RFC822 requires the Gregorian calendar, doesn't it?
The time zone or name or abbreviation, should the module have supported them.
The feast for the day, in long format ("jour de la pomme de terre"). Also available as %Ej.
A literal `%' character.
Only the floating time zone is supported. Time zones were created in the late XIXth century, at a time when fast communication (railroads) and instant communication (electric telegraph) made it necessary. But at this time, the French Revolutionary calendar was no longer in use.
They are not supported.
For the moment, only French and English are available. For the English translation, I have used Thomas Carlyle's book and Alan Taylor's web site at kokogiak.com (see below). Then, I have checked some translations with Wikipedia and Jonathan Badger's French Revolutionary Calendar module written in Ruby.
Some feast names are not translated, other's translations are doubtful (they are flagged with a question mark). Remarks are welcome.
Support for this module is provided via the firstname.lastname@example.org email list. See http://lists.perl.org/ for more details.
Please enter bug reports at http://rt.cpan.org/
Jean Forget <JFORGET@cpan.org>
based on Dave Rolsky's DateTime module, Eugene van der Pijll's DateTime::Calendar::Pataphysical module and my prior Date::Convert::French_Rev module.
The development of this module is hosted by Les Mongueurs de Perl, http://www.mongueurs.net/.
date(1), strftime(3), perl(1), DateTime(3), DateTime::Calendar::Pataphysical(3), Date::Convert::French_Rev
calendar/cal-french.el in emacs-21.2 or later or xemacs 21.1.8
Quid 2001, M and D Frémy, publ. Robert Laffont
Agenda Républicain 197 (1988/89), publ. Syros Alternatives
Any French schoolbook about the French Revolution
The French Revolution, Thomas Carlyle, Oxford University Press
Calendrier Militaire, anonymous
Histoire de l'heure en France, Jacques Gapaillard, publ. Vuibert -- ADAPT
http://www.kokogiak.com/frc/default.asp (the link still exists, but it seems to no longer include stuff about the French Revolutionary calendar.)
Copyright (c) 2003, 2004, 2010, 2012, 2014, 2016 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.16.3.
This program is distributed under the same terms as Perl 5.16.3: GNU Public License version 1 or later and Perl Artistic License
You can find the text of the licenses in the LICENSE file or at http://www.perlfoundation.org/artistic_license_1_0 and http://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 <http://www.gnu.org/licenses/> or write to the Free Software Foundation, Inc., http://fsf.org.