Dela via


GetCurrentDateTimeStatic (NoSQL-fråga)

GÄLLER FÖR: NoSQL

Returnerar aktuellt DATUM och tid för UTC (Coordinated Universal Time) som en ISO 8601-sträng.

Viktigt!

Den statiska varianten av den här funktionen hämtar bara datum och tid en gång per partition. Mer information om den icke-statiska varianten finns i GetCurrentDateTime

Syntax

GetCurrentDateTimeStatic()

Returtyper

Returnerar det aktuella utc-datum- och tidssträngsvärdet i formatet resväg (ISO 8601).

Kommentar

Mer information om tur och retur-format finns i .NET-tur och retur-format. Mer information om FORMATET ISO 8601 finns i ISO 8601.

Exempel

I det här exemplet används en container med en partitionsnyckelsökväg för /pk. Det finns tre objekt i containern med två objekt inom samma logiska partition och ett objekt i en annan logisk partition.

[
  {
    "id": "1",
    "pk": "A"
  },
  {
    "id": "2",
    "pk": "A"
  },
  {
    "id": "3",
    "pk": "B"
  }
]

Den här funktionen returnerar samma statiska datum och tid för objekt inom samma partition. Som jämförelse hämtar den icke-statiska funktionen ett nytt datum- och tidsvärde för varje objekt som matchas av frågan.

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

Kommentar

Det är möjligt att objekt i olika logiska partitioner finns i samma fysiska partition. I det här scenariot skulle det statiska datum- och tidsvärdet vara identiskt.

Kommentarer

  • 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.

Se även