timeadd Function
timeadd
adds a duration to a timestamp, returning a new timestamp.
In the Terraform language, timestamps are conventionally represented as
strings using RFC 3339
"Date and Time format" syntax. timeadd
requires the timestamp
argument
to be a string conforming to this syntax.
duration
is a string representation of a time difference, consisting of
sequences of number and unit pairs, like "1.5h"
or "1h30m"
. The accepted
units are "ns"
, "us"
(or "µs"
), "ms"
, "s"
, "m"
, and "h"
. The first
number may be negative to indicate a negative duration, like "-2h5m"
.
The result is a string, also in RFC 3339 format, representing the result of adding the given direction to the given timestamp.
Examples