Skip to content

Documentation / @interstellar-tools/types / TimeScaleType

Type Alias: TimeScaleType ​

ts
type TimeScaleType = 'UTC' | 'TAI' | 'TT' | 'UT1' | 'TDB' | 'GPS';

Defined in: temporal.ts:181

A time scale: the clock a moment is read on.

  • UTC: Coordinated Universal Time, the civil clock, and what a JavaScript Date holds. Leap seconds keep it within 0.9 s of Earth's rotation.
  • TAI: International Atomic Time, a steady atomic clock. TAI − UTC is a whole number of seconds that grows by one at each leap second.
  • TT: Terrestrial Time, the time scale of most astronomical formulas, such as the J2000 epoch: TT = TAI + 32.184 s.
  • UT1: time by Earth's actual rotation angle. It drifts from UTC by up to 0.9 s, and following it closely takes measurements published by the IERS.
  • TDB: Barycentric Dynamical Time, the time scale of the planetary ephemerides and of JPL Horizons. It runs within 1.7 ms of TT, ahead and behind over the year as Earth's orbit takes it nearer and farther from the Sun.
  • GPS: the time kept by the GPS satellites, TAI − 19 s. It hasn't taken a leap second since 1980.

Example ​

ts
const scale: TimeScaleType = 'TT';