Time Conversion

Time Scale Conversions

Convert between major astronomical time scales (UTC, TT, TAI, TDB, UT1).

post/time/scales

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/time/scales
  • 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

from_scalestring

Input time scale (utc, tt, tai, tdb, ut1)

julian_daynumber double required

Julian Day to convert

latitudenumber

Observer latitude

longitudenumber

Observer longitude

Response

Successful Response

delta_tnumber required

Delta T value used (seconds)

jd_tainumber double required

Julian Day in International Atomic Time

jd_tdbnumber double required

Julian Day in Barycentric Dynamical Time

jd_ttnumber double required

Julian Day in Terrestrial Time

jd_ut1number double required

Julian Day in Universal Time 1

jd_utcnumber double required

Julian Day in Coordinated Universal Time

offsets_secondsobject required

Offsets in seconds between scales relative to TT

Example response

{
  "delta_t": 69.18,
  "jd_tai": 2461114.50043,
  "jd_tdb": 2461114.500802,
  "jd_tt": 2461114.500801,
  "jd_ut1": 2461114.5000007,
  "jd_utc": 2461114.5,
  "offsets_seconds": {
    "tai_tt": 32.184,
    "tt_tdb": 0.0016
  }
}

Changes

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