astro_date_convert

Calendar and timezone conversions — julian-gregorian, timezone, easter-date.

Layer: utility
Methods: julian-gregorian, timezone, easter-date
Free tier: julian-gregorian, timezone, easter-date
Paid tier: —

Description

Calendar and timezone conversions — julian-gregorian, timezone, easter-date.

Methods:
  julian-gregorian [Free] — convert a date between the Julian and Gregorian calendars, with Julian Day Number + weekday
  timezone         [Free] — convert a wall-clock date/time from one IANA timezone to another via UTC
  easter-date      [Free] — date of Easter for a year in the Western (Gregorian) or Orthodox (Julian) tradition

Input schema

julian-gregorian

Field	Type	Required	Constraints
date.year	integer	yes	min -4712, max 4000, int
date.month	integer	yes	min 1, max 12, int
date.day	integer	yes	min 1, max 31, int
calendar	"julian" \| "gregorian"	yes	—

Example request

{
  "method": "julian-gregorian",
  "date": {
    "year": 1642,
    "month": 12,
    "day": 25
  },
  "calendar": "julian"
}

Example response (captured; long values elided)

{
  "gregorian": {
    "year": 1643,
    "month": 1,
    "day": 4
  },
  "julian": {
    "year": 1642,
    "month": 12,
    "day": 25
  },
  "jdn": 2321157,
  "weekday": "Sunday"
}

timezone

Field	Type	Required	Constraints
dateTime.year	integer	yes	min 1900, max 2100, int
dateTime.month	integer	yes	min 1, max 12, int
dateTime.day	integer	yes	min 1, max 31, int
dateTime.hour	integer	yes	min 0, max 23, int
dateTime.minute	integer	yes	min 0, max 59, int
dateTime.second	integer	no	min 0, max 59, int
fromZone	string	yes	minLength 1
toZone	string	yes	minLength 1

Example request

{
  "method": "timezone",
  "dateTime": {
    "year": 2024,
    "month": 6,
    "day": 1,
    "hour": 12,
    "minute": 0
  },
  "fromZone": "Europe/London",
  "toZone": "America/New_York"
}

Example response (captured; long values elided)

{
  "utc": {
    "zone": "UTC",
    "year": 2024,
    "month": 6,
    "day": 1,
    "hour": 11,
    "minute": 0,
    "second": 0,
    "offsetMinutes": 0
  },
  "from": {
    "zone": "Europe/London",
    "year": 2024,
    "month": 6,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "second": 0,
    "offsetMinutes": 60
  },
  "to": {
    "zone": "America/New_York",
    "year": 2024,
    "month": 6,
    "day": 1,
    "hour": 7,
    "minute": 0,
    "second": 0,
    "offsetMinutes": -240
  }
}

easter-date

Field	Type	Required	Constraints
year	integer	yes	min 326, max 4000, int
tradition	"western" \| "orthodox"	no	—

Example request

{
  "method": "easter-date",
  "year": 2024
}

Example response (captured; long values elided)

{
  "year": 2024,
  "tradition": "western",
  "gregorian": {
    "year": 2024,
    "month": 3,
    "day": 31
  },
  "julian": {
    "year": 2024,
    "month": 3,
    "day": 18
  }
}