Duration Syntax

Durations are specified with positive integers and unit specifiers.

Unit specifiers include the following:

  • ms: milliseconds

  • s: seconds

  • m: minutes

  • h: hours

  • d: days

  • w: weeks

A duration of 1 week is specified as 1w. A duration of 1 week, 1 day, 1 hour, 1 minute, and 1 second is specified as 1w1d1h1m1s.

Whitespace surrounding the value and the unit specifier is not significant. For example, "5d" is equivalent to " 5 d ".

Not all properties taking a duration allow all unit specifiers. For example, milliseconds are not allowed if durations smaller than one second are not permitted.

Some properties limit minimum or maximum durations.

An unlimited duration is specified using unlimited (recommended for readability) or -1.