absDuration
Signature
Section titled “Signature”absDuration(value: string): stringimport { absDuration } from "@northguild/gmt/duration/calculate";Return the absolute value of an ISO 8601 duration string.
- Uses Temporal.Duration.from and .abs, then .toString() to re-emit.
- Like
negateDuration, this only touches signs, so it never needsrelativeToand works on calendar-unit durations. - An already-positive duration is returned re-emitted, not rejected — but re-emitted means canonicalized, so “P0D” comes back as “PT0S”.
- Returns “” when
valueis not a valid ISO 8601 duration string.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
value |
string |
ISO 8601 duration string |
Returns
Section titled “Returns”ISO 8601 duration string with a positive sign, or “” on invalid input
Examples
Section titled “Examples”absDuration("-P1DT2H") // "P1DT2H"absDuration("P1DT2H") // "P1DT2H"absDuration("-P1Y2M") // "P1Y2M" (no relativeTo needed)absDuration("PT0S") // "PT0S"absDuration("not a duration") // ""