Freigeben über

GetCurrentDateTimeStatic (NoSQL-Abfrage)

GILT FÜR: NoSQL

Gibt den aktuellen UTC-Datums-/Uhrzeitwert (koordinierte Weltzeit) als ISO 8601-Zeichenfolge zurück.

Wichtig

Die statische Variante dieser Funktion ruft Datum und Uhrzeit nur einmal pro Partition ab. Weitere Informationen zur nicht statischen Variante finden Sie unter GetCurrentDateTime.

Syntax

GetCurrentDateTimeStatic()

Rückgabetypen

Gibt den aktuellen Zeichenfolgewert für UTC-Datum/Uhrzeit im Roundtrip-Format (ISO 8601).

Hinweis

Weitere Informationen zum Roundtrip-Format finden Sie im Abschnitt zum .NET-Roundtrip-Format. Weitere Informationen zum ISO 8601-Format finden Sie unter ISO 8601.

Beispiele

In diesem Beispiel wird ein Container mit dem Partitionsschlüsselpfad /pk verwendet. Es gibt drei Elemente im Container: zwei Elemente in derselben logischen Partition und ein Element in einer anderen logischen Partition.

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

Diese Funktion gibt den gleichen statischen Datums-/Uhrzeitwert für Elemente in derselben Partition zurück. Zum Vergleich erhält die nicht statische Funktion einen neuen Datums-/Uhrzeitwert für jedes Element, das von der Abfrage abgeglichen wird.

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

Hinweis

Es ist möglich, dass Elemente in verschiedenen logischen Partitionen in derselben physischen Partition vorhanden sind. In diesem Szenario wäre der statische Datums-/Uhrzeitwert identisch.

Bemerkungen

  • Diese statische Funktion wird einmal pro Partition aufgerufen.
  • Statische Versionen von Systemfunktionen rufen die jeweiligen Werte nur einmal während der Bindung ab und werden wie bei den nicht statischen Versionen der gleichen Funktionen nicht wiederholt zur Laufzeit ausgeführt.

Weitere Informationen