Files
opentf/website/docs/configuration/functions/timeadd.html.md
Nick Fagerlund 596e529602 website: Adopt a ton of pages into the "language" layout
As of this commit, that layout doesn't exist yet, but I'm isolating the one-line
changes to their own commit to try and keep your eyes from glazing over.
2020-10-26 18:19:26 -07:00

1.3 KiB

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
language timeadd - Functions - Configuration Language docs-funcs-datetime-timeadd The timeadd function adds a duration to a timestamp, returning a new timestamp.

timeadd Function

-> Note: This page is about Terraform 0.12 and later. For Terraform 0.11 and earlier, see 0.11 Configuration Language: Interpolation Syntax.

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

timeadd(timestamp, duration)

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

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