parseIsoInstant — @gj-kit/format

A public function from @gj-kit/format. The signature below is taken directly from the 0.1.1 release declaration.

Verified import example

import { parseIsoInstant } from '@gj-kit/format';

Signature, parameters, and return type

/**
 * Strict ISO 8601 → instant. Returns null for null/undefined/empty input and
 * for anything outside the accepted grammar — parsing failure is a data error,
 * never a throw.
 *
 * Accepted: `YYYY-MM-DD` | `YYYY-MM-DD(T| )HH:mm[:ss[.fff]][Z|±HH:MM|±HHMM]`,
 * year 1–9999, calendar-valid components (no rollover: `'2026-02-30'` is null).
 *
 * Implemented with a regular expression and `Date.UTC` arithmetic — the engine's
 * own string parser is never used, so the result does not vary between V8,
 * JavaScriptCore and Hermes the way parsing a string with `Date` does.
 */
declare function parseIsoInstant(value: string | null | undefined, options: IsoParseOptions): Date | null;

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

Release context

• Package: @gj-kit/format
• Version: 0.1.1
• Public entry: .
• Source: GitHub