GetCurrentDateTimeStatic (requête NoSQL)

  • Article

S’APPLIQUE À : NoSQL

Retourne la date et l’heure UTC actuelles sous forme de chaîne ISO 8601.

Important

La variante statique de cette fonction ne récupère la date et l’heure qu’une seule fois par partition. Pour plus d’informations sur la variante non statique, consultez GetCurrentDateTime

Syntaxe

GetCurrentDateTimeStatic()

Types de retour

Retourne la valeur de chaîne de date et d’heure UTC actuelle au format aller-retour (ISO 8601).

Notes

Pour plus d’informations sur le format aller-retour, consultez Format aller-retour .NET. Pour plus d’informations sur le format ISO 8601, consultez ISO 8601.

Exemples

Cet exemple utilise un conteneur avec un chemin d’accès de clé de partition de /pk. Il existe trois éléments dans le conteneur avec deux éléments dans la même partition logique, et un élément dans une partition logique différente.

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

Cette fonction retourne la même date et heure statique pour les éléments de la même partition. À des fins de comparaison, la fonction non statique obtient une nouvelle valeur de date et d’heure pour chaque élément mis en correspondance par la requête.

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

Notes

Il est possible que des éléments de partitions logiques différentes existent dans la même partition physique. Dans ce scénario, la date statique et la valeur date seraient identiques.

Notes

  • Cette fonction statique est appelée une fois par partition.
  • Les versions statiques des fonctions système n’obtiennent leurs valeurs respectives qu’une seule fois pendant la liaison, au lieu de s’exécuter à plusieurs reprises dans le runtime, comme c’est le cas pour les versions non statiques des mêmes fonctions.

Voir aussi