# formatCcsdsAsciiA

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
formatCcsdsAsciiA(isoString: string, fractionalSecondDigits?: FractionalDigit): string
```

Write an instant as a CCSDS ASCII Time Code A string (`YYYY-MM-DDThh:mm:ss.d…dZ`).

- CCSDS 301.0-B-4 §3.5.1.1. The instant is converted to UTC; the `Z` is always written.
- `fractionalSecondDigits` works as in Temporal's `toString`: omitted or `"auto"` writes the shortest fraction that keeps every nanosecond, `0` writes no fraction and no period, and `1` to `9` write exactly that many digits. Extra digits are cut, never rounded, so the result never moves into the next second, day or year.
- An inserted leap second is written as `…T23:59:60Z`. A second of 60 that is not one of the 27 inserted leap seconds (for example `2016-12-31T23:58:60Z`) returns "".
- "" for a date-time with no offset, a UTC year outside 0001 to 9999, a `fractionalSecondDigits` Temporal refuses (`10`, `-1`, `null`, `"3"`), and invalid input.

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `isoString` | `string` | ISO 8601 instant string, with `Z` or an offset |
| `fractionalSecondDigits` | `FractionalDigit` | `"auto"` (default) or 0 to 9 |

## Returns

the Code A text, or "" on invalid input

## Related types

- [`FractionalDigit`](/gmt/reference/types/FractionalDigit/)

## Examples

```ts
import { formatCcsdsAsciiA } from "@northguild/gmt/timescale/format";

formatCcsdsAsciiA("2024-06-15T12:30:00.123456789+02:00", 6) // "2024-06-15T10:30:00.123456Z"
```

## Source

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