Skip to content

parseDateFromUtc

parseDateFromUtc(value: string, options?: { timeZone?: string; }): string

Extract the date portion from a UTC datetime string.

  • Uses Temporal.Instant.from to parse, converts to UTC date.
  • Returns "" for invalid input.
ParameterTypeDescription
valuestringISO UTC datetime string (e.g., “2024-03-17T14:30:45Z”)

options

The time zone the value is read in

OptionTypeDefaultDescription
timeZone?string"UTC"The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone identifier such as +05:30, +0530 or -08, or a stored offset ±HH:MM[:SS], what getTimeZoneOffset returns), or "local" for the system time zone. An unknown zone returns "".

ISO date string (e.g., “2024-03-17”) or "" on invalid input

import { parseDateFromUtc } from "@northguild/gmt/utc/parse";
parseDateFromUtc("2024-03-17T14:30:45Z") // "2024-03-17"
output 

utc/parse/parseDateFromUtc.ts