Skip to content

fromTT

  • The core functions, which every industry uses.
fromTT(ttString: string): string

Convert a Terrestrial Time string to a UTC instant string.

  • Reads YYYY-MM-DDTHH:MM:SS[.fraction] TT: four-digit year, T, seconds required, 1 to 9 fraction digits after ., one space, TT (the FITS 4.0 time-scale token). FITS’s deprecated TDT and ET are not read. TT has no second 60.
  • UTC = TT − 32.184 s − (TAI − UTC), from the IERS leap-second table built into GMT (Leap_Second.dat through Bulletin C 72, 6 July 2026). The table is closed: after the last insertion (2016-12-31) TAI − UTC stays 37 s.
  • During an inserted leap second the result is …T23:59:60Z (ITU-R TF.460-6 Annex 3). Only the timescale/, gnss/ and finance/ functions read that string back; other GMT functions reject a second of 60.
  • "" before 1972-01-01T00:00:42.184 TT and on invalid input.
ParameterTypeDescription
ttStringstringTT time-scale string

ISO 8601 UTC instant string (Z), or "" on invalid input or a date before 1972

import { fromTT } from "@northguild/gmt/timescale/convert";
fromTT("2026-01-01T00:01:09.184 TT") // "2026-01-01T00:00:00Z"
output 

timescale/convert/fromTT.ts

© 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.