• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Packer
  • Install
  • Tutorials
  • Documentation
  • Guides
  • Plugins
  • Try Cloud(opens in new tab)
  • Sign up
Packer Home

Documentation

Skip to main content
  • Documentation
  • HCP Packer

  • Terminology
    • Overview
      • Overview
        • Overview
          • formatdate
          • timeadd
          • timestamp
          • legacy_isotime
          • legacy_strftime
      • Variables
      • Locals
      • Contextual Variables
      • Data Sources
      • Path Variables
      • Syntax
      • Only Except
      • Expressions
      • JSON Syntax


  • Installing Packer
  • Configuring Packer

  • Integration Program

  • Debugging

  • Resources

  • Tutorial Library
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. Packer
  3. Documentation
  4. Templates
  5. HCL Templates
  6. Functions
  7. Date and Time Functions
  8. timeadd
  • Packer
  • v1.7.x
  • v1.6.x
  • v1.5.x

»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.

Breaking change note: Packer previously let you decide your own "Date and Time format" syntax. With HCL2 and for parity with Terraform, Packer will be using the RFC 3339 "Date and Time format" syntax. As a string. formatdate still allows you to format a date.

Examples

> timeadd("2017-11-22T00:00:00Z", "10m")
2017-11-22T00:10:00Z
Edit this page on GitHub

On this page

  1. timeadd Function
  2. Examples
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)