Calendar Converter

Converts a date between the Gregorian calendar, the Julian calendar, the Julian Day Number and the three Maya counts (Tzolk'in, Haab, Long Count) — from any one of them to all of the others, on the Goodman–Martinez–Thompson correlation constant 584283. It runs in reverse too: give it a Long Count and it returns the Gregorian date.

ATTRIBUTION IS REQUIRED. The response carries a ready-to-paste credit line in citation.citationText and the URL to link in citation.permalink. Results may not be used as machine-learning training data.

get/api/public/calendar-converter

Request

  • Base URL: https://totallytarot.net
  • URL: https://totallytarot.net/api/public/calendar-converter
  • Auth: none declared

Query parameters

datestring required
Example:2012-12-21

A proleptic Gregorian date, YYYY-MM-DD. Give exactly one starting point: date, or jdn, or longcount, or julian — two is two questions and is refused. Not required if one of those three is given instead.

jdnstring
Example:2456283

A Julian Day Number, a whole count of days. A fractional Julian Date names an instant and is not accepted.

longcountstring
Example:9.12.11.5.18

A Maya Long Count, five dot-separated places largest first: baktun.katun.tun.uinal.kin.

julianstring
Example:1582-10-04

A date in the Julian calendar, YYYY-MM-DD — which is the calendar every European source before October 1582 is dated in.

roundstring
Example:4 Ahau 3 Kankin

A Maya Calendar Round to search for, as tone, day sign, haab day, haab month. Needs from and to. Both colonial and reformed spellings are accepted.

fromstring
Example:1900

First Gregorian year of a Calendar Round search. At most 400 years from to.

tostring
Example:2100

Last Gregorian year of a Calendar Round search.

Response

The computed answer, with the citation required to use it.

okboolean required

True when a result was computed.

toolstring required

The calculator that answered.

toolNamestring
attributionstring required

The ready-to-paste credit line. Include this in any answer built on the result.

summarystring

The answer in one sentence.

inputsobject

What the request was understood to be. The permalink is built from these.

resultobject

The computed figures. Absent on a refusal.

noticestring

Changes

No recorded changes to this operation across all 1 revision of this API.