Durations
A duration represents a non-negative period of time.
Duration units
Durations can be specified in any of the following units:
| Unit | Description |
|---|
| ns | Nanoseconds |
| us | Microseconds, alternative: µs |
| ms | Milliseconds |
| s | Seconds |
| m | Minutes |
| h | Hours |
| d | Days |
| w | Weeks |
| y | Years |
Creating and using durations
A duration can be composed of any number of duration units.
1y40w20h;
A duration that contains multiple instances of the same unit type will parse as well, combining lesser units into greater units when a maximum value is reached.
For example, a duration that includes 12h two times will be evaluated as 1d.
1d1d12h12h;
A duration can also be created by casting a string.
<duration>"1d1d12h12h";
A duration can be zero, but cannot be negative.
0ns;
0d;
The maximum possible duration can be accessed via the const duration::max, above which a duration cannot be formed.
duration::max;
duration::max + 1ns
Durations can be added to and subtracted from other durations as well as datetimes.
d'1970-01-01' + 1d;
1y - 6w;
46w1d;
Multiplying and dividing durations
Available since: v3.0.1
A duration can be multiplied and divided by a number.
1d / 24;
1d * 5.5;
