tcgMinusTt
Signature
Section titled “Signature”tcgMinusTt(isoString: string): number | nullReturn 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
toTCGapplies: computed exactly, floored to the nanosecond. - A listed leap second (
…T23:59:60Z) is accepted. nullbefore 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.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
isoString | string | ISO 8601 instant string; a listed leap second (…T23:59:60Z) is accepted |
Returns
Section titled “Returns”TCG − TT in seconds, or null on invalid input or a date before 1972
Examples
Section titled “Examples”import { tcgMinusTt } from "@northguild/gmt/timescale/calculate";
tcgMinusTt("2026-01-01T00:00:00Z") // 1.077661917Source
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.