Skip to content

tcgMinusTt

  • The core functions, which every industry uses.
tcgMinusTt(isoString: string): number | null

Return TCG − TT, in seconds, at a UTC instant.

  • TCG − TT = (L_G / (1 − L_G)) × (TT − T₀), L_G = 6.969290134 × 10⁻¹⁰ (IAU 2000 B1.9), T₀ = 1977-01-01T00:00:32.184 TT (IERS TN 36 §10.1, eq. 10.1). Zero at T₀ (1976-12-31T23:59:45Z), negative before it, growing about 22 ms a year.
  • The value is the offset toTCG applies: computed exactly, floored to the nanosecond.
  • A listed leap second (…T23:59:60Z) is accepted.
  • null before 1972-01-01 (no integer TAI − UTC, so no TT), for a second-60 string on a day with no insertion, and on invalid input.
ParameterTypeDescription
isoStringstringISO 8601 instant string; a listed leap second (…T23:59:60Z) is accepted

TCG − TT in seconds, or null on invalid input or a date before 1972

import { tcgMinusTt } from "@northguild/gmt/timescale/calculate";
tcgMinusTt("2026-01-01T00:00:00Z") // 1.077661917
output 

timescale/calculate/tcgMinusTt.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.