Compartilhar via


GETCURRENTDATETIMESTATIC – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A GETCURRENTDATETIMESTATIC função retorna o mesmo valor de data e hora UTC para todos os itens na consulta, como uma cadeia de caracteres ISO 8601. Isso é útil para carimbos de data/hora consistentes nos resultados da consulta.

Sintaxe

GETCURRENTDATETIMESTATIC()

Tipos de retorno

Retorna a data e a hora UTC atuais como uma cadeia de caracteres no formato ISO 8601, consistente para todos os itens na consulta.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Obter data e hora atuais estáticas e não estáticas

Neste exemplo, a GETCURRENTDATETIMESTATIC função é usada para retornar o mesmo carimbo de data/hora para todos os itens, enquanto GetCurrentDateTime retorna um valor diferente para cada item.

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

Observações

  • Essa função estática é chamada uma vez por partição.
  • As versões estáticas das funções do sistema só obtêm seus respectivos valores uma vez durante a associação, em vez de serem executadas repetidamente no runtime, como é o caso das versões não estáticas das mesmas funções.