GetCurrentDateTimeStatic (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Devolve a data e hora UTC (Hora Universal Coordenada) atual como uma cadeia ISO 8601.

Importante

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

Syntax

GetCurrentDateTimeStatic()

Tipos de devolução

Devolve o valor atual da cadeia de data e hora UTC no formato de ida e volta (ISO 8601).

Nota

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

Exemplos

Este exemplo utiliza um contentor com um caminho de chave de partição de /pk. Existem três itens no contentor com dois itens na mesma partição lógica e um item numa partição lógica diferente.

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

Esta função devolve a mesma data e hora estáticas para os itens na 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"
  }
]

Nota

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

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 os respetivos valores uma vez durante o enlace, em vez de serem executadas repetidamente no runtime, como é o caso das versões não estáticas das mesmas funções.

Ver também