Skip to content

Terrestrial Time Stack

  • The core functions, which every industry uses.

Three offsets sit between a UTC timestamp and TCG, and each is a different kind of offset. TAI − UTC steps: it is a whole number of seconds that rises by one at each inserted second. TT − TAI is constant. TCG − TT drifts: it is negative before 1977, zero at the epoch IAU 2000 Resolution B1.9 fixes, and it grows for ever after. The tool draws them as one bar from UTC, a different pattern for each piece, with the size in words under every piece. It does not tell them apart by colour alone.

The bar’s scale is fixed from the first year to the last on the slider, so it never rescales while you drag. The drift lane under it plots TCG − TT across the same years, with a cursor at your year. The headline plate gives TT − UTC, the gap a UTC timestamp carries when it is passed as an ephemeris’s TT argument, and the table writes the instant on all four scales and spells each label back to UTC.

TT is the geocentric scale of Earth ephemerides. Barycentric work uses a different scale, TDB, which this tool does not show. Type a UTC instant, or paste a label that ends in TAI, TT or TCG after one space, such as 2026-01-01T00:01:09.184 TT. The ending picks the scale the value is read on. Drag the slider to move to 1 January of any year from 1972 to 9999. The presets reach the dates around an inserted second.

1. Say what a clock reads

At the start of 2026 in UTC, TT is 69.184 seconds ahead, and TCG is about 1.08 seconds ahead of TT.

A UTC instant such as 2026-01-01T00:00:00Z, or a label followed by a space and TAI, TT or TCG.

2. How far TT is from UTC

TT − UTC
no result
TAI − UTC
no result
TT − TAI
no result
TCG − TT
no result
  • TAI − UTC no result, steps at each inserted second
  • TT − TAI no result, constant
  • TCG − TT no result, drifts with time
  • steps at each inserted second
  • constant
  • drifts with time

 

3. The same instant on every scale

The same instant on every scale
ScaleCallLabelBack to UTC
UTC
 
no result
no result
TAI
 
no result
no result
TT
 
no result
no result
TCG
 
no result
no result
 

4. What the library returns

To TT. toTT writes a UTC instant as a TT label. TT is TAI plus a constant (IERS Technical Note 36, section 10.1), so the label is ahead of UTC by the leap-second steps plus that constant. It returns "" before 1972, and for a second 60 on a day with no inserted second.

From TT. fromTT reads a TT label back to UTC. A label whose token is TDT or ET is refused, because those name TT’s older predecessors and not TT.

To TCG. toTCG writes the instant on TCG. The label is TT’s, plus the drift that IAU 2000 Resolution B1.9 defines, written to the nanosecond.

From TCG. fromTCG reads a TCG label back to UTC, rounding toward the earlier nanosecond.

The drift. tcgMinusTt returns TCG − TT in seconds at a UTC instant, or null before 1972. It is the number toTCG applies, so the lane and the table agree.

toTT("2026-01-01T00:00:00Z"); // "2026-01-01T00:01:09.184 TT"
toTCG("2026-01-01T00:00:00Z"); // "2026-01-01T00:01:10.261661917 TCG"
tcgMinusTt("2026-01-01T00:00:00Z"); // 1.077661917
tcgMinusTt("1976-12-31T23:59:45Z"); // 0
tcgMinusTt("9999-01-01T00:00:00Z"); // 176.427468382
tcgMinusTt("1971-01-01T00:00:00Z"); // null
toTT("1971-01-01T00:00:00Z"); // ""
fromTT("2026-01-01T00:01:09.184 TT"); // "2026-01-01T00:00:00Z"
fromTCG("2026-01-01T00:01:10.261661917 TCG"); // "2026-01-01T00:00:00Z"

Worth trying: A TT label — it reads back to midnight in UTC. The same instant on TCG — 1.08 seconds further on. Where TCG and TT agree — the gap is zero. The first day of integer UTC — TCG reads behind TT. Inside a leap second — each scale has a label for it. The year 9999 — the drift is larger than TT − UTC is today. Before 1972 — the library answers "" and null, and the tool shows NO SIGNAL.

Reference: toTT, fromTT, toTCG, fromTCG and tcgMinusTt. The guide is Leap Seconds and TAI.

© 2026 NorthGuild · Licences

Code examples: MIT-0. Packages: MIT. Third-party data and components: their own licences, credited where they appear. Everything else: © 2026 NorthGuild, all rights reserved.