Date::Converter - Convert dates between calendar systems
use Date::Converter; my $converter = new Date::Converter('julian', 'gregorian'); my ($year, $month, $day) = $converter->convert(2009, 2, 23);
Date::Converter provides a method for converting the date between calendars of different types. Current version includes converters for Alexandrian, Armenian, Bahai, Coptic, Ethiopian, Gregorian, Hebrew, Islamic, Julian, Macedonian, Persian, Roman, Republican, Saka, Syrian, Tamil and Zoroastrian calendars in any combination.
Module converts groups of three values (year, month, day) into another group of three values belonging to different calendar. To execute the conversion, first create an instance of a converter for the desired pair of calendars:
my $converter = new Date::Converter('armenian', 'hebrew');
Then use this instance and pass three values to it:
my ($year, $month, $day) = $converter->convert(1450, 6, 9);
Result is an array of corresponding values in the target calendar.
Names of the source and the destinations are case insensitive and include these:
alexandrian armenian bahai coptic ethiopian gregorian hebrew islamic julian macedonian persian republican roman saka syrian tamil zoroastrian
Some calendars are known under synonymical names in literature. Such as Tamil which is also reffered as Hindu Solar.
Any conversation is performed via so called Julian Ephemeris Date (JED), which is the fixed date somewhere far in the past. JED value is not available via module's interface though.
Code of the converters themself is located in respective submodule, for example Date::Converter::Syrian. Modules are loaded on demand, thus you will not silencely load calendars that you are not going to use.
Andrew Shitov, <firstname.lastname@example.org>
Algorithms which are implemented in submodules are re-written from Fortran library CALPAC made by John Burkardt. The library was issued under GNU LGPL (http://people.sc.fsu.edu/~burkardt/txt/gnu_lgpl.txt) licence.
Date::Converter and Date::Converter::* modules are free software. You may redistribute and (or) modify it under the same terms as Perl.
Note to follow GNU LGPL licence which was applicabale to initial Fortran library and part of test data which are located now in t/reper.t test file.