# tcgMinusTt

Industry: Core

:::caution[Unreleased]
Not in `@northguild/gmt` 1.21.0 on npm yet. It is on `main` and ships in the next release.
:::

## Signature

```ts
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.

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `isoString` | `string` | ISO 8601 instant string; a listed leap second (`…T23:59:60Z`) is accepted |

## Returns

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

## Examples

```ts
import { tcgMinusTt } from "@northguild/gmt/timescale/calculate";

tcgMinusTt("2026-01-01T00:00:00Z") // 1.077661917
```

## Source

[timescale/calculate/tcgMinusTt.ts](https://github.com/northguild/gmt/blob/main/packages/gmt/src/timescale/calculate/tcgMinusTt.ts)
