Duration literals

A duration literal is a representation of a length of time. It has an integer part and a duration unit part. Multiple durations may be specified together and the resulting duration is the sum of each smaller part. When several durations are specified together, larger units must appear before smaller ones, and there can be no repeated units.

duration_lit = { int_lit duration_unit } .
duration_unit = "h" | "m" | "s" | "ms" | "us" | "µs" | "ns" .
UnitsMeaning
hhour (60 minutes)
mminute (60 seconds)
ssecond
msmilliseconds (1 thousandth of a second)
us or µsmicroseconds (1 millionth of a second)
nsnanoseconds (1 billionth of a second)

Durations represent a length of time. Lengths of time are dependent on specific instants in time they occur and as such, durations do not represent a fixed amount of time. Hours (h) is the largest duration unit as it is the larged unit not affected by daylight savings adjustments. Larger units such as days, months, or years in the future.

Examples of duration literals
1s
1h15m  // 1 hour and 15 minutes
72h // 72h hrs = 3 days