GETCURRENTDATETIMESTATIC – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen GETCURRENTDATETIMESTATIC returnerar samma UTC-datum- och tidsvärde för alla objekt i frågan som en ISO 8601-sträng. Detta är användbart för konsekventa tidsstämplar mellan frågeresultat.

Syntax

GETCURRENTDATETIMESTATIC()

Returtyper

Returnerar aktuellt UTC-datum och tid som en sträng i ISO 8601-format, konsekvent för alla objekt i frågan.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Hämta statiskt och icke-statiskt aktuellt datum och tid

I det här exemplet GETCURRENTDATETIMESTATIC används funktionen för att returnera samma tidsstämpel för alla objekt, medan GetCurrentDateTime returnerar ett annat värde för varje objekt.

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

Anmärkningar

• Den här statiska funktionen anropas en gång per partition.
• Statiska versioner av systemfunktioner får bara sina respektive värden en gång under bindningen, i stället för att köras upprepade gånger i körningen, vilket är fallet för de ickestatiska versionerna av samma funktioner.