Skip to content

parseUnitFromTime

parseUnitFromTime(value: string, unit: SmallestUnit<"hour" | "minute" | "second" | "millisecond" | "microsecond" | "nanosecond">): string

Return a specific time unit extracted from a PlainTime string.

  • Extracts “hour”, “minute”, “second”, “millisecond”, “microsecond” or “nanosecond” from a PlainTime.
  • Returns zero-padded string for hour, minute, second (2 digits) and millisecond, microsecond and nanosecond (3 digits, each the 0-999 Temporal field).
  • unit accepts the singular or plural name ("hour" or "hours"), as Temporal does.
  • Returns "" for invalid input.
ParameterTypeDescription
valuestringISO PlainTime string
unitSmallestUnit<"hour" | "minute" | "second" | "millisecond" | "microsecond" | "nanosecond">unit to extract from the time

string representation of the requested unit or "" on invalid input

import { parseUnitFromTime } from "@northguild/gmt/plain/parse";
parseUnitFromTime("14:30:45.123", "hour") // "14"
output 

plain/parse/parseUnitFromTime.ts