Udostępnij za pośrednictwem

GetCurrentDateTimeStatic (zapytanie NoSQL)

  • Artykuł

DOTYCZY: NoSQL

Zwraca bieżącą datę i godzinę UTC (uniwersalny czas koordynowany) jako ciąg ISO 8601.

Ważne

Statyczna odmiana tej funkcji pobiera tylko datę i godzinę raz na partycję. Aby uzyskać więcej informacji na temat niestatycznej odmiany, zobacz GetCurrentDateTime

Składnia

GetCurrentDateTimeStatic()

Typy zwracane

Zwraca bieżącą wartość ciągu daty i godziny UTC w formacie round-trip (ISO 8601).

Uwaga

Aby uzyskać więcej informacji na temat formatu dwukierunkowego, zobacz Format zaokrąglonej podróży platformy .NET. Aby uzyskać więcej informacji na temat formatu ISO 8601, zobacz ISO 8601.

Przykłady

W tym przykładzie użyto kontenera ze ścieżką /pkklucza partycji . W kontenerze znajdują się trzy elementy z dwoma elementami w tej samej partycji logicznej i jeden element w innej partycji logicznej.

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

Ta funkcja zwraca tę samą statyczną datę i godzinę dla elementów w ramach tej samej partycji. Dla porównania funkcja niestatyczna pobiera nową wartość daty i godziny dla każdego elementu dopasowanego przez zapytanie.

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

Uwaga

Istnieje możliwość istnienia elementów w różnych partycjach logicznych w tej samej partycji fizycznej. W tym scenariuszu statyczna wartość daty i godziny będzie taka sama.

Uwagi

  • Ta funkcja statyczna jest wywoływana raz na partycję.
  • Statyczne wersje funkcji systemowych pobierają tylko odpowiednie wartości raz podczas tworzenia powiązania, a nie są wykonywane wielokrotnie w środowisku uruchomieniowym, tak jak w przypadku niestatycznych wersji tych samych funkcji.

Zobacz też