maya-dates 1.2.3
Install from the command line:
Learn more about npm packages
$ npm install @drewsonne/maya-dates@1.2.3
Install via package.json:
"@drewsonne/maya-dates": "1.2.3"
About this version
A typescript library for interacting with and modifying both the Maya Long Count (LC) and Calendar Round (CR) dates.
npm install [-g] @drewsonne/maya-dates
import LongCountFactory from "@drewsonne/maya-dates/lib/factory/long-count";
// Long Count from Initial Series on east side of Stele E, Quirigua
let lc = new LongCountFactory().parse('9.17.0.0.0');
console.log(`${lc.buildFullDate()}`);
This should print 13 Ajaw 18 Kumk'u 9.17. 0. 0. 0
.
Most implementations will consist of creating a fullDate, and passing it to an operation.
Creating a fullDate can be done either by:
- using a factory class (LongCountFactory,
CalendarRoundFactory,
FullDateFactory)
and calling its
parse(raw_string)
function, whereraw_string
is a LC, CR, or CR and LC combination encoded as a string. To specify missing values in a fullDate, using*
. For example,
import {Wildcard, isWildcard} from "@drewsonne/maya-dates/lib/wildcard"
import LongCountFactory from "@drewsonne/maya-dates/lib/factory/long-count";
import CalendarRoundFactory from "@drewsonne/maya-dates/lib/factory/calendar-round";
import FullDateFactory from "@drewsonne/maya-dates/lib/factory/full-date";
const wildcard = new Wildcard();
const partial_lc = new LongCountFactory().parse('9.17.0.0.*');
const partial_cr = new CalendarRoundFactory().parse('13 Ajaw * Kumk\'u');
const partial_date = new FullDateFactory().parse('13 Ajaw * Kumk\'u 9.17.0.0.*');
console.log(`LC: ${isWildcard(partial_lc.kIn)}`);
console.log(`CR: ${isWildcard(partial_cr.haab.coeff)}`);
console.log(`Full Date: ${isWildcard(partial_date.lc.kIn)}`);
- passing explicit values into a model factory or class (getCalendarRound, LongCount, FullDate).
import {getCalendarRound} from "@drewsonne/maya-dates/lib/cr/calendar-round";
import {getHaab} from "@drewsonne/maya-dates/lib/cr/haab";
import {getTzolkin} from "@drewsonne/maya-dates/lib/cr/tzolkin";
import {getHaabMonth} from "@drewsonne/maya-dates/lib/cr/component/haabMonth";
import {getTzolkinDay} from "@drewsonne/maya-dates/lib/cr/component/tzolkinDay";
import {coefficientParser as _} from "@drewsonne/maya-dates/lib/cr/component/coefficient"
import {FullDate} from "@drewsonne/maya-dates/lib/full-date"
import {LongCount} from "@drewsonne/maya-dates/lib/lc/long-count"
const calendarRound = getCalendarRound(
getTzolkin(_(13), getTzolkinDay('Ajaw')),
getHaab(_(18), getHaabMonth('Kumk\'u'))
);
const lc = new LongCount(0, 0, 0, 17, 9);
const fullDate = new FullDate(calendarRound, lc);
console.log(`${lc}`);
console.log(`${calendarRound}`);
console.log(`${fullDate}`);
Once a full date object has been created, you can either add an integer to a fullDate
using shift(number)
, or filling in missing values in wildcards. The
operations
namespace provides operators to expand a fullDate with a wildcard into all possible
values for dates matching that wildcard pattern.
Full documentation and reference can be found at https://drewsonne.github.io/maya-dates/.