Skip to content

parseTimeFromUtc

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

Extract the time portion from a UTC datetime string.

  • Uses Temporal.Instant.from to parse, converts to the timeZone option’s zone.
  • 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 time string (e.g., “14:30:45”) or "" on invalid input

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

utc/parse/parseTimeFromUtc.ts