Time Conversion

Calendar conversion to Julian Day Number

Bridge between civil calendars and astronomical time. Handles BCE dates.

post/time/julian-day

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/time/julian-day
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Request body

calendarstring

Calendar system to use (e.g. proleptic_gregorian, julian)

daynumber required

Day of the month, can include fractional days

hournumber

Hour of the day (0-23)

minutenumber

Minute of the hour (0-59)

monthinteger required

Month of the year (1-12)

secondnumber

Second of the minute (0-59)

time_scalestring

Time scale (utc, tt)

yearinteger required

Astronomical year (0 = 1 BCE, -1 = 2 BCE)

Response

Successful Response

input_interpretationobject required

Metadata about the input date/calendar

julian_daynumber double required

Julian Day number

julian_day_terrestrialnumber double required

Julian Day in Terrestrial Time (TT)

modified_julian_daynumber double required

Modified Julian Day (JD - 2400000.5)

valid_rangeobject required

Validity range for high-precision calculations

Example response

{
  "julian_day": 2451545
}

Changes

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