Freigeben über


GETCURRENTDATETIME - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die GETCURRENTDATETIME Funktion gibt das aktuelle UTC(Coordinated Universal Time)-Datum und die aktuelle Uhrzeit als ISO 8601-Zeichenfolge zurück.

Syntax

GETCURRENTDATETIME()

Rückgabetypen

Gibt den aktuellen UTC-Datums- und Uhrzeitzeichenfolgenwert im Roundtrip-Format (ISO 8601) zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Abrufen des aktuellen UTC-Datums und der aktuellen Uhrzeit

In diesem Beispiel wird die GETCURRENTDATETIME Funktion verwendet, um das aktuelle UTC-Datum und die aktuelle UHRZEIT zurückzugeben.

SELECT VALUE {
  currentUtcDateTime: GETCURRENTDATETIME()
}
[
  {
    "currentUtcDateTime": "2019-05-03T20:36:17.1234567Z"
  }
]

Bemerkungen

  • Diese Funktion verwendet den Index nicht.
  • Diese Funktion ist nicht deterministisch.
  • Das zurückgegebene Ergebnis ist UTC (Coordinated Universal Time) mit einer Genauigkeit von sieben Ziffern und einer Genauigkeit von 100 Nanosekunden.
  • Wenn Sie Werte mit der aktuellen Uhrzeit vergleichen müssen, rufen Sie die aktuelle Uhrzeit vor der Abfrageausführung ab, und verwenden Sie diesen konstanten Zeichenfolgenwert in der WHERE Klausel.