GETCURRENTDATETIMESTATIC — язык запросов в Cosmos DB (в Azure и Fabric)

Функция GETCURRENTDATETIMESTATIC возвращает одно и то же значение даты и времени UTC для всех элементов запроса в виде строки ISO 8601. Это полезно для согласованных меток времени в результатах запроса.

Синтаксис

GETCURRENTDATETIMESTATIC()

Типы возвращаемых данных

Возвращает текущую дату и время в формате UTC в формате ISO 8601, согласованную для всех элементов в запросе.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Получение статических и нестатических текущих дат и времени

В этом примере 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"
  }
]

Замечания

  • Эта статическую функцию вызывается один раз на секцию.
  • Статические версии системных функций получают соответствующие значения только один раз во время привязки, а не выполняются многократно в среде выполнения, как и для нестатических версий одних и таких же функций.