timeadd Function

timeadd adds a duration to a timestamp, returning a new timestamp.

timeadd(timestamp, duration)

In the OpenTofu language, timestamps are conventionally represented as strings using RFC 3339 (opens in a new tab) "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

> timeadd("2017-11-22T00:00:00Z", "10m")
2017-11-22T00:10:00Z

Related Functions

• timecmp determines an ordering for two timestamps.