Skip to content

fromTCG

  • The core functions, which every industry uses.
fromTCG(tcgString: string): string

Convert a Geocentric Coordinate Time string to a UTC instant string.

  • Reads YYYY-MM-DDTHH:MM:SS[.fraction] TCG: four-digit year, T, seconds required, 1 to 9 fraction digits after ., one space, TCG (the FITS 4.0 time-scale token). TCG has no second 60.
  • TT = TCG − L_G × (TCG − T₀), the inverse of IERS TN 36 eq. 10.1 solved from dTT/dTCG = 1 − L_G (IAU 2000 B1.9) with T₀ from eq. 10.1; the floor is GMT’s nanosecond rule. Then UTC from TT as fromTT does.
  • Exact inverse of toTCG to the nanosecond. About one TCG nanosecond in 1.4 × 10⁹ is never written by toTCG; it reads as the next nanosecond’s UTC instant.
  • 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.07398781 TCG and on invalid input.
ParameterTypeDescription
tcgStringstringTCG time-scale string

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

import { fromTCG } from "@northguild/gmt/timescale/convert";
fromTCG("2026-01-01T00:01:10.261661917 TCG") // "2026-01-01T00:00:00Z"
output 

timescale/convert/fromTCG.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.