» timeadd Function

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

timeadd(timestamp, duration)

In the Packer 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

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