GetCurrentDateTimeStatic (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna a data e a hora atuais em UTC (Tempo Universal Coordenado) como uma cadeia de caracteres ISO 8601.

Importante

A variação estática dessa função só recupera a data e hora uma vez por partição. Para obter mais informações sobre a variação não estática, consulte GetCurrentDateTime

Sintaxe

GetCurrentDateTimeStatic()

Tipos de retorno

Retorna o valor da cadeia de caracteres de data e hora atuais em UTC no formato viagem de ida e volta (ISO 8601).

Observação

Para obter mais informações sobre o formato de viagem de ida e volta, consulte Formato de viagem de ida e volta do .NET. Para obter mais informações sobre o formato ISO 8601, consulte ISO 8601.

Exemplos

Esse exemplo usa um contêiner com um caminho de chave de partição de /pk. Há três itens no contêiner, sendo dois itens na mesma partição lógica e um item em uma partição lógica diferente.

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

Essa função retorna a mesma data e hora estáticas para itens dentro da mesma partição. Para comparação, a função não estática obtém um novo valor de data e hora para cada item correspondente à 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"
  }
]

Observação

É possível que itens em diferentes partições lógicas existam na mesma partição física. Nesse cenário, o valor estático de data e hora seria idêntico.

Comentários

  • Essa função estática é chamada uma vez por partição.
  • As versões estáticas das funções do sistema obtêm seus respectivos valores apenas 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.

Confira também