跳至主要内容

plantimestamp 函数

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

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

此函数的结果将在每次计划操作中发生变化。它旨在用于 自定义条件 中，作为验证诸如 TLS 证书之类的时效性资源的一种方法。

在某些情况下，例如在 OpenTofu 仅刷新 计划期间，此函数的值将重新计算但不会传播到配置中定义的资源。因此，建议仅将此函数用于与提供程序导出的时间戳进行比较，而不是与配置中生成的时间戳进行比较。

plantimestamp 函数在 OpenTofu 控制台中不可用。

示例​

代码块
> plantimestamp()
2018-05-13T07:44:12Z
代码块
check "opentofu_org_certificate" {
  data "tls_certificate" "opentofu_org" {
    url = "https://www.opentofu.org/"
  }

  assert {
    condition = timecmp(plantimestamp(), data.tls_certificate.opentofu_org.certificates[0].not_after) < 0
    error_message = "opentofu.org certificate has expired"
  }
}
  • timestamp 在应用步骤中进行评估时返回当前时间戳。