addTime
Signature
Section titled “Signature”addTime(value: string, units: Partial<Record<TimeDurationUnit, number>>, options?: { overflow?: Overflow; }): stringimport { addTime } from "@northguild/gmt/plain/calculate";Return a PlainTime ISO string with units added to value.
- Validates
value,units, andamountbefore performing the add. - Returns “” for invalid inputs.
overflow(“constrain” (default) | “reject”) is accepted for API consistency with sibling add functions, but PlainTime arithmetic always wraps around the clock (e.g. 23:00 + 2 hours = 01:00) rather than producing an out-of-range value, so it has no observable effect here.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
value |
string |
ISO PlainTime string |
units |
Partial<Record<TimeDurationUnit, number>> |
Partial<Record<TimeDurationUnit, number>> object specifying units to add |
Options
Section titled “Options”options
| Option | Type | Default |
|---|---|---|
overflow? |
Overflow |
— |
Returns
Section titled “Returns”ISO PlainTime string after addition, or “” on invalid input
Related types
Section titled “Related types”Examples
Section titled “Examples”addTime("12:00:00", { hours: 1 }) // "13:00:00"addTime("invalid", { hours: 1 }) // ""