Delen via

GetCurrentDateTimeStatic (NoSQL-query)

  • Artikel

VAN TOEPASSING OP: NoSQL

Retourneert de huidige UTC-datum en -tijd (Coordinated Universal Time) als een ISO 8601-tekenreeks.

Belangrijk

De statische variatie van deze functie haalt slechts één keer per partitie de datum en tijd op. Zie voor meer informatie over de niet-statische variatie GetCurrentDateTime

Syntaxis

GetCurrentDateTimeStatic()

Retourtypen

Retourneert de huidige UTC-datum- en tijdtekenreekswaarde in de ISO 8601-indeling (round-trip ).

Notitie

Zie de .NET-indeling voor retouren voor meer informatie over de roundtrip-indeling. Zie ISO 8601 voor meer informatie over de ISO 8601-indeling.

Voorbeelden

In dit voorbeeld wordt een container gebruikt met een partitiesleutelpad van /pk. Er zijn drie items in de container met twee items binnen dezelfde logische partitie en één item in een andere logische partitie.

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

Deze functie retourneert dezelfde statische datum en tijd voor items binnen dezelfde partitie. Ter vergelijking krijgt de niet-statische functie een nieuwe datum- en tijdwaarde voor elk item dat overeenkomt met de query.

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

Notitie

Het is mogelijk dat items in verschillende logische partities aanwezig zijn in dezelfde fysieke partitie. In dit scenario is de statische datum- en tijdwaarde identiek.

Opmerkingen

  • Deze statische functie wordt eenmaal per partitie aangeroepen.
  • Statische versies van systeemfuncties krijgen alleen hun respectieve waarden eenmaal tijdens de binding, in plaats van herhaaldelijk uit te voeren in de runtime, zoals het geval is voor de niet-statische versies van dezelfde functies.

Zie ook