# parseCcsdsAsciiB

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
parseCcsdsAsciiB(value: string): string
```

Read a CCSDS ASCII Time Code B (`YYYY-DDDThh:mm:ss.d…dZ`, day of year) as an ISO 8601 UTC instant string in calendar form.

- CCSDS 301.0-B-4 §3.5.1.2. `DDD` is the day of the year, 001 to 365, or 366 in a leap year (the ISO 8601 ordinal date). The code is UTC, so a code without its optional `Z` is still read as UTC, never as a local time.
- Years 0001 to 9999, leading zeros in every field, upper-case `T` and `Z`, and `.` as the only decimal sign.
- The seconds must be present. A shorter subset such as `2024-167` or `2024-167T10:30` returns "", because it names a span of time, not an instant.
- The fraction keeps the digits as sent, trailing zeros included. Digits after the ninth are dropped, never rounded, because Temporal holds nanoseconds.
- A second of 60 is read only at one of the 27 inserted leap seconds (IERS table built into GMT) and is returned as `…T23:59:60Z`.

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `value` | `string` | CCSDS ASCII Time Code B text |

## Returns

the instant as `YYYY-MM-DDThh:mm:ss[.f]Z`, or "" when `value` is not a Code B time

## Examples

```ts
import { parseCcsdsAsciiB } from "@northguild/gmt/timescale/parse";

parseCcsdsAsciiB("1988-018T17:20:43.123456Z") // "1988-01-18T17:20:43.123456Z" — CCSDS's own example
```

## Source

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