DateTimeDiff (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Devolve a diferença, como um número inteiro assinado, da parte de data e hora especificada entre dois valores de data e hora.

Sintaxe

DateTimeDiff(<date_time_part>, <start_date_time>, <end_date_time>)

Argumentos

Description
date_time_part Uma cadeia que representa uma parte de uma especificação de formato de data ISO 8601. Esta parte é utilizada para indicar o aspeto da data a comparar.
start_date_time Uma cadeia de data e hora Universal Coordenada (UTC) no formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
end_date_time Uma cadeia de data e hora Universal Coordenada (UTC) no formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Nota

Para obter mais informações sobre o formato ISO 8601, consulte ISO 8601.

Tipos de devolução

Devolve um valor numérico que é um número inteiro assinado.

Exemplos

Os exemplos seguintes comparam 4 de fevereiro de 2019 16:00 UTC e 5 de março de 2018 05:00 UTC com várias partes de data e hora.

SELECT VALUE {
    diffPastYears: DateTimeDiff("yyyy", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastMonths: DateTimeDiff("mm", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastDays: DateTimeDiff("diffDays", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastHours: DateTimeDiff("hh", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastSeconds: DateTimeDiff("ss", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffFutureYears: DateTimeDiff("yyyy", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureMonths: DateTimeDiff("mm", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureDays: DateTimeDiff("diffDays", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureHours: DateTimeDiff("hh", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureSeconds: DateTimeDiff("ss", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000")
}

[
  {
    "diffPastYears": -1,
    "diffPastMonths": -11,
    "diffPastHours": -8075,
    "diffPastSeconds": -29070000,
    "diffFutureYears": 1,
    "diffFutureMonths": 11,
    "diffFutureHours": 8075,
    "diffFutureSeconds": 29070000
  }
]

Observações

  • Esta função devolve undefined por estes motivos:
    • A parte de data e hora especificada é inválida.
    • A data e hora no argumento de início ou fim não é uma cadeia de data e hora ISO 8601 válida.
  • O formato de data ISO 8601 especifica partes de data e hora válidas a utilizar com esta função: | | Formato | | --- | --- | | Dia | day, dd, d | | Hora | hour, hh | | Minuto | minute, mi, n | | Segundo | second, ss, s | | Milissegundos | millisecond, ms | | Microssegundos | microsecond, mcs | | Nanossegundo | nanosecond, ns |
  • A função devolve sempre um valor inteiro assinado. A função devolve uma medição do número de limites cruzados para a parte de data e hora especificada, não uma medição do intervalo de tempo.

Conteúdo relacionado