Catholic Liturgical Calendar

Data Generation Endpoint

A Liturgical Calendar API from which you can retrieve data for the Liturgical events of any given year from 1970 to 9999, whether for the Universal or General Roman Calendar or for derived National and Diocesan calendars

If a national or diocesan calendar is requested, these calendars will automatically set the specific options in the API request. If instead no national or diocesan calendar is requested (i.e. the Universal Calendar is requested) then the more specific options can be requested:

URL for the API request based on selected options (the above button is set to this URL):

Calculation of the Date of Easter

A simple API endpoint that returns data about the Date of Easter, both Gregorian and Julian, from 1583 (year of the adoption of the Gregorian Calendar) to 9999 (maximum possible date calculation in 64bit PHP), using a PHP adaptation of the Meeus/Jones/Butcher algorithm for Gregorian easter (observed by the Roman Catholic church) and of the Meeus algorithm for Julian easter (observed by orthodox churches)

Currently the data can be requested with the following localizations:
  • English: /dateOfEaster.php?locale=EN
  • Italian: /dateOfEaster.php?locale=IT
  • Latin: /dateOfEaster.php?locale=LA
In any case, since the API returns a UNIX timestamp for each date of Easter, localizations can be done in a client application just as well.
Data Generation Endpoint: Definition
Calculation of the Date of Easter

Example display of the date of Easter from 1583 to 9999