NAME

Date::Calendar::Maya::Astronomical - conversions from/to the Maya calendar

SYNOPSIS

use Date::Calendar::Maya::Astronomical;
my Date $d-greg .= new(2020, 6, 20);
my Date::Calendar::Maya::Astronomical
        $d-maya .= new-from-date($d-greg);

say "{.tzolkin} {.haab} {.long-count}" with $d-maya;
# --> 10 Cib  19 Zotz 13.0.7.10.16
$d-maya.locale = 'en';
say "{.tzolkin} {.haab}" with $d-maya;
# --> 10 Owl 19 Bat

DESCRIPTION

Date::Calendar::Maya::Astronomical is a class which implements the Maya calendars (long count, Haab and Tzolkin).

This class uses the Astronomical correlation, as named by the website http://research.famsi.org/date_mayaLC.php. This may refer to some carved stone with a date and describing an astronomical event such as an eclipse, which has been adopted as the basis for the correlation. Other classes uses the Goodman-Martinez-Thompson correlation or the Spinden correlation

Mayas used three different calendars, the Long Count, the civil calendar or "Haab" and the clerical calendar or "Tzolkin".

The civil calendar is organized like other calendars, with days grouped in months grouped in years. The difference with other calendars is that the months last 20 days each, not around 30, and there are 18 months, not 12. Days are numbered 0 to 19, not 1 to 20. In theory months are not numbered, but in this module they are, for convenience reasons. In addition, there are 5 additional days (uyaeb), but no leap days are defined.

A last difference with other calendars is that years are not numbered.

The clerical calendar consists of two simultaneous cycles, the first one with numbers 1 to 13, the second one with 20 names. This gives a clerical year of 260 days. As for the civil calendar, the 20 names are numbered for convenience reasons.

The long count consists of five embedded cycles:

• kin or day

• uinal, 1 uinal = 20 days

• tun, 1 tun = 18 uinals

• katun, 1 katun = 20 tuns

• baktun, 1 baktun = 20 katuns

The uinal can be considered as a month, its duration is the same as the Haab month. The tun is a bit shorter than a solar year, 360 days instead of 365.24.

See the full documentation in the main class Date::Calendar::Maya.

AUTHOR

Jean Forget <J2N-FORGET at orange dot fr>

COPYRIGHT AND LICENSE

Copyright (c) 2020, 2023, 2024 Jean Forget

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.