GetCurrentDateTimeStatic(NoSQL 查询)

适用范围: NoSQL

以 ISO 8601 字符串形式返回当前 UTC(协调世界时)日期和时间。

重要

此函数的静态变体在每个分区仅检索日期和时间一次。 有关非静态变体的详细信息,请参阅 GetCurrentDateTime

语法

GetCurrentDateTimeStatic()

返回类型

往返 (ISO 8601) 格式返回当前 UTC 日期和时间字符串值。

注意

有关往返格式的详细信息,请参阅 .NET 往返格式

示例

此示例使用分区键路径为 /pk 的容器。 容器中有三个项,其中两个项位于同一逻辑分区中,另一个项位于不同的逻辑分区中。

[
  {
    "id": "1",
    "pk": "A"
  },
  {
    "id": "2",
    "pk": "A"
  },
  {
    "id": "3",
    "pk": "B"
  }
]

此函数为同一分区中的项返回相同的静态日期和时间。 为了进行比较,非静态函数为查询匹配的每个项获取新的日期和时间值。

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"
  }
]

注意

不同逻辑分区中的项可能存在于同一物理分区中。 在此方案中,静态日期和时间值将相同。

备注

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

另请参阅