通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

GetCurrentDateTimeStatic（NoSQL 查询）

  • 项目

适用范围： NoSQL

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

重要

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

语法

GetCurrentDateTimeStatic()

返回类型

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

注意

有关往返格式的详细信息，请参阅 .NET 往返格式。 有关 ISO 8601 格式的详细信息，请参阅 ISO 8601。

示例

此示例使用分区键路径为 /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"
  }
]

注意

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

备注

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

另请参阅