共用方式為

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

注意

不同的邏輯分割區中的專案可以存在於相同的實體分割區中。 在此案例中，靜態日期和時間值會相同。

備註

  • 每個分割區會呼叫此靜態函式一次。
  • 系統函式的靜態版本只會在系結期間取得其各自的值一次，而不是在運行時間重複執行，就像相同函式的非靜態版本一樣。

另請參閱