GETCURRENTDATETIMESTATIC - Cosmos DB 中的查询语言(在 Azure 和 Fabric 中)

GETCURRENTDATETIMESTATIC 函数为查询中的所有项返回相同的 UTC 日期和时间值,作为 ISO 8601 字符串。 这对于跨查询结果的一致时间戳非常有用。

Syntax

GETCURRENTDATETIMESTATIC()

返回类型

以 ISO 8601 格式的字符串的形式返回当前 UTC 日期和时间,该字符串与查询中的所有项保持一致。

例子

本部分包含有关如何使用此查询语言构造的示例。

获取静态和非静态当前日期和时间

在此示例中,该 GETCURRENTDATETIMESTATIC 函数用于返回所有项的相同时间戳,同时 GetCurrentDateTime 为每个项返回不同的值。

SELECT
  i.id,
  i.pk AS partitionKey,
  GetCurrentDateTime() AS nonStaticDateTime,
  GETCURRENTDATETIMESTATIC() AS staticDateTime
FROM
    items i
[
  {
    "id": "1",
    "partitionKey": "A",
    "nonStaticDateTime": "2023-06-28T18:32:12.4500994Z",
    "staticDateTime": "2023-06-28T18:32:12.4499507Z"
  },
  {
    "id": "2",
    "partitionKey": "A",
    "nonStaticDateTime": "2023-06-28T18:32:12.4501101Z",
    "staticDateTime": "2023-06-28T18:32:12.4499507Z"
  },
  {
    "id": "3",
    "partitionKey": "B",
    "nonStaticDateTime": "2023-06-28T18:32:12.4501181Z",
    "staticDateTime": "2023-06-28T18:32:12.4401181Z"
  }
]

注解

  • 每个分区调用一次此静态函数。
  • 系统函数的静态版本仅在绑定期间获取其各自的值一次,而不是在运行时重复执行,就像相同函数的非静态版本一样。