subtractTime

Signature

subtractTime(value: string, units: Partial<Record<"hours" | "minutes" | "seconds" | "milliseconds" | "microseconds" | "nanoseconds", number>>): string

Return a PlainTime ISO string with units subtracted from value.

• Validates value, units, and amount before performing the subtract.
• Returns "" for invalid inputs. There is no options argument (its only member, overflow, was removed in 1.16.0): Temporal PlainTime#subtract takes no options and always wraps around the clock (e.g. 01:00 - 2 hours = 23:00).

Parameters

Parameter	Type	Description
value	string	ISO PlainTime string
units	Partial<Record<"hours" | "minutes" | "seconds" | "milliseconds" | "microseconds" | "nanoseconds", number>>	Partial<Record<TimeDurationUnit, number>> object specifying units to subtract

Returns

ISO PlainTime string after subtraction, or "" on invalid input

Related types

• TimeDurationUnit

Examples

import { subtractTime } from "@northguild/gmt/plain/calculate";

subtractTime("14:30:00", { hours: 1 }) // "13:30:00"

value

output

 

Source

plain/calculate/subtractTime.ts