Condividi tramite


GETCURRENTDATETIMESTATIC - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La GETCURRENTDATETIMESTATIC funzione restituisce lo stesso valore di data e ora UTC per tutti gli elementi della query, come stringa ISO 8601. Ciò è utile per i timestamp coerenti tra i risultati della query.

Sintassi

GETCURRENTDATETIMESTATIC()

Tipi restituiti

Restituisce la data e l'ora UTC correnti come stringa in formato ISO 8601, coerente per tutti gli elementi della query.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Ottenere data e ora correnti statiche e non statiche

In questo esempio, la GETCURRENTDATETIMESTATIC funzione viene usata per restituire lo stesso timestamp per tutti gli elementi, mentre GetCurrentDateTime restituisce un valore diverso per ogni elemento.

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

Osservazioni:

  • Questa funzione statica viene chiamata una volta per partizione.
  • Le versioni statiche delle funzioni di sistema ottengono i rispettivi valori una sola volta durante l'associazione, anziché essere eseguite ripetutamente nel runtime, come accade per le versioni non statiche delle stesse funzioni.