Partilhar 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 devolução

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

Examples

Esta seção contém exemplos de como usar essa construção 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

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