fromTCG
Signature
Section titled “Signature”fromTCG(tcgString: string): stringConvert 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
fromTTdoes. - Exact inverse of
toTCGto the nanosecond. About one TCG nanosecond in 1.4 × 10⁹ is never written bytoTCG; 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 thetimescale/,gnss/andfinance/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.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
tcgString | string | TCG time-scale string |
Returns
Section titled “Returns”ISO 8601 UTC instant string (Z), or "" on invalid input or a date before 1972
Examples
Section titled “Examples”import { fromTCG } from "@northguild/gmt/timescale/convert";
fromTCG("2026-01-01T00:01:10.261661917 TCG") // "2026-01-01T00:00:00Z"Source
Section titled “Source”© 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.