ISO-8601 Duration String (PnYnMnDTnHnMnS) Math & Interval Combiner

Variable Month Lengths & Clamping

A duration of P1M added to January 31 cannot result in "February 31". Modern standards require clamping the day to the last valid day of the target month (February 28 or 29). Adding P1M across summer months (July to August) spans 31 days (2,678,400 seconds), whereas across February it spans only 28 days (2,419,200 seconds).

Daylight Saving Time (DST) Discontinuities

Adding a duration of P1D to a timestamp shifts the calendar date by exactly 1 day (e.g., Sunday 10:00 AM to Monday 10:00 AM), which may encompass 23 or 25 physical hours on DST transition weekends. In contrast, adding PT24H guarantees exactly 86,400 physical seconds, shifting the local time by 1 hour on DST switch dates.

JS Temporal API

The modern Temporal.Duration API natively parses and serializes ISO-8601 durations:

const d = Temporal.Duration.from("P1Y2M");
const totalHours = d.total({ unit: "hours", relativeTo: "2026-01-01" });

Period & Duration Classes

Java strictly bifurcates calendar periods from clock-based durations:

Period period = Period.parse("P1Y2M10D");
Duration time = Duration.parse("PT3H30M");
LocalDate target = LocalDate.now().plus(period);

isodate & relativedelta

Python parses full compound periods through isodate:

import isodate
duration = isodate.parse_duration("P1Y2M10DT3H")
target = datetime.now() + duration