Compartir vía


GETCURRENTDATETIMESTATIC - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La GETCURRENTDATETIMESTATIC función devuelve el mismo valor de fecha y hora UTC para todos los elementos de la consulta, como una cadena ISO 8601. Esto resulta útil para marcas de tiempo coherentes entre los resultados de la consulta.

Syntax

GETCURRENTDATETIMESTATIC()

Tipos de retorno

Devuelve la fecha y hora UTC actuales como una cadena en formato ISO 8601, coherente para todos los elementos de la consulta.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Obtención de la fecha y hora actuales estáticas y no estáticas

En este ejemplo, la GETCURRENTDATETIMESTATIC función se usa para devolver la misma marca de tiempo para todos los elementos, mientras que GetCurrentDateTime devuelve un valor diferente para cada elemento.

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

Observaciones

  • 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.