跳至主要内容

timestamp 函数

timestamp 以 RFC 3339 格式返回一个 UTC 时间戳字符串。

在 OpenTofu 语言中，时间戳通常使用 RFC 3339“日期和时间格式”语法以字符串形式表示，因此 timestamp 以此格式返回字符串。

此函数的结果将每秒更改一次，因此直接在资源属性中使用此函数将导致在每次 OpenTofu 运行时检测到差异。我们不建议在资源属性中使用此函数，但在某些情况下，它可以与 ignore_changes 生命周期元参数 结合使用，仅在资源首次创建时获取时间戳。有关更稳定的时间处理，请参阅 时间提供程序。

由于返回值不断变化，因此无法在 OpenTofu 的计划阶段预测此函数的结果，因此时间戳将仅在应用计划时获取。

示例​

代码块
> timestamp()
2018-05-13T07:44:12Z
  • formatdate 可以将结果时间戳转换为其他日期和时间格式。
  • plantimestamp 将返回一个一致的时间戳，表示计划期间的日期和时间。