Compartir vía

GetCurrentDateTimeStatic (consulta NoSQL)

  • Artículo

SE APLICA A: NoSQL

Devuelve la fecha y hora actual de la hora UTC (hora universal coordinada) como una cadena ISO 8601.

Importante

La variación estática de esta función solo recupera la fecha y la hora una vez por partición. Para saber más sobre la variación no estática, consulte GetCurrentDateTime

Sintaxis

GetCurrentDateTimeStatic()

Tipos de valores devueltos

Devuelve el valor de la cadena de fecha y hora UTC actuales en el formato ida y vuelta (ISO 8601).

Nota

Para saber más sobre el formato ida y vuelta, vea Formato ida y vuelta de .NET. Para más información sobre el formato ISO 8601, consulte ISO_8601.

Ejemplos

En este ejemplo se usa un contenedor con una ruta de acceso de clave de partición de /pk. Hay tres elementos en el contenedor con dos elementos dentro de la misma partición lógica y un elemento en una partición lógica diferente.

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

Esta función devuelve la misma fecha y hora estáticas para los elementos de la misma partición. En comparación, la función no estática obtiene un nuevo valor de fecha y hora para cada elemento coincidente con la consulta.

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

Nota

Es posible que los elementos de diferentes particiones lógicas existan en la misma partición física. En este escenario, el valor estático de fecha y hora sería idéntico.

Comentarios

  • Esta función estática se llama una vez por partición.
  • Las versiones estáticas de las funciones del sistema solo obtienen sus respectivos valores una vez durante el enlace, en lugar de ejecutarse repetidamente en el tiempo de ejecución como es el caso de las versiones no estáticas de las mismas funciones.

Consulte también