api.radiantdrift.com
  • Radiant Drift API
    • Subscription Plans
    • Educational Use and Research
    • API End Points
  • Getting Started
    • About your account
    • Request Authentication
    • Managing API Keys
    • OpenAPI Specification
    • Date/Time Format
    • Validity, Accuracy, and Precision
  • Usage Guidelines
    • Acceptable Use Policy
    • Usage Credits and Call Costs
    • Attribution
    • Rate Limits
  • Julian Day
  • Delta-T
  • Rise, Transit, Set Times
  • Body Position
    • Request Parameters
    • Position at a given time
    • Positions for a time range
    • Observer location
  • Solar Eclipses
    • Embeddable Web Widgets
      • Eclipse Map
      • Eclipse Simulator
    • Besselian Elements
    • Local Circumstances
    • Eclipse Paths
    • Five Millennium Canon of Solar Eclipses
  • The Moon
    • Lunar Libration
    • Lunar Limb Profile
  • Geospatial
    • Geodesic
    • Elevation
  • Reference
    • Definitions
    • Errors
Powered by GitBook
On this page

Julian Day

Convert a Gregorian calendar date/time to a Julian Day or vice versa.

PreviousRate LimitsNextDelta-T

Last updated 1 year ago

All input dates are assumed to be in the Gregorian calendar. Even if you provide a date earlier than the first adoption of the Gregorian calendar, it is taken as is and is not assumed to be a Julian calendar date.

Calculate Julian Day

Calculate Gregorian Date/Time

Returns the Julian Day for a given date

get
Authorizations
Path parameters
datestringRequired

The desired date/time in the Gregorian calendar.

Example: 2024-10-15T22:00:00.000Z
Responses
200Success
application/json
4XX
Not Found
application/json
get
GET /julian-day/{date} HTTP/1.1
Host: api.radiantdrift.com
Accept: */*
{
  "query": {
    "name": "julian-day",
    "date": "2024-10-15T22:00:00.000Z",
    "cost": 1
  },
  "response": {
    "julianDay": 2460599.41666667
  }
}

Returns the date/time for a given Julian day

get
Authorizations
Path parameters
julian-daynumberRequired

Julian day value.

Example: 2460000
Responses
200Success
application/json
4XX
Not Found
application/json
get
GET /date/{julian-day} HTTP/1.1
Host: api.radiantdrift.com
Accept: */*
{
  "query": {
    "name": "date",
    "julianDay": 2460000,
    "cost": 1
  },
  "response": {
    "date": "2023-02-24T12:00:00.000Z"
  }
}
  • Calculate Julian Day
  • GETReturns the Julian Day for a given date
  • Calculate Gregorian Date/Time
  • GETReturns the date/time for a given Julian day