Partilhar via

GetCurrentDateTimeStatic (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

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

Importante

A variação estática desta função só recupera a data e a 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 devolução

Retorna o valor atual da cadeia de caracteres 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 do .NET. Para obter mais informações sobre o formato ISO 8601, consulte ISO 8601.

Exemplos

Este exemplo usa um contêiner com um caminho de chave de partição de /pk. Há três itens no contêiner com dois itens dentro da 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"
  }
]

Esta função retorna a mesma data e hora estática 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 correspondido pela 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 itens em partições lógicas diferentes existam na mesma partição física. Nesse cenário, o valor estático de data e hora 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 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.

Consulte também