Skip to content

parseRfc3339

parseRfc3339(value: string): string

Parse a strict RFC 3339 datetime string into a zoned ISO 8601 datetime string.

  • Accepts T, t, or a single space as the date/time separator (all three are valid RFC 3339, unlike GMT’s own zoned strings which always use T) and either Z/z or a numeric ±HH:MM offset.
  • RFC 3339 carries no IANA zone name, so the parsed offset becomes the result’s time zone identifier too (e.g. Z → +00:00[+00:00]) — the same fixed-offset-as-zone convention parseRfc2822 uses.
  • Z and -00:00 become +00:00. RFC 9557 §2.2 (updating RFC 3339 §4.3) gives Z and the older -00:00 the meaning “the time in UTC is known, but the offset to local time is unknown”, unlike +00:00. A Temporal offset cannot carry that distinction, so it is lost; the instant is exact.
  • Rejects GMT’s own bracketed zoned strings (...+00:00[UTC]) — that annotation is not valid RFC 3339 input; use Temporal.ZonedDateTime.from / isValidZonedDateTime directly for GMT’s native format instead.
ParameterTypeDescription
valuestringRFC 3339 datetime string (e.g. “2024-03-15T14:30:00-04:00”)

zoned ISO 8601 datetime string, or "" on invalid input

import { parseRfc3339 } from "@northguild/gmt/zoned/parse";
parseRfc3339("2024-03-15T14:30:00-04:00") // "2024-03-15T14:30:00-04:00[-04:00]"
output 

zoned/parse/parseRfc3339.ts