Megosztás a következőn keresztül:

DateTimeDiff (NoSQL-lekérdezés)

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Aláírt egész számként visszaadja a megadott dátum- és időrész különbségét két dátum- és időérték között.

Syntax

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

Argumentumok

Leírás
date_time_part Az ISO 8601 dátumformátum-specifikációjának egy részét képviselő sztring. Ez a rész a dátum összehasonlítandó aspektusának jelzésére szolgál.
start_date_time Az ISO 8601 formátumú YYYY-MM-DDThh:mm:ss.fffffffZegyezményes világidő (UTC) dátum- és idősztringje.
end_date_time Az ISO 8601 formátumú YYYY-MM-DDThh:mm:ss.fffffffZegyezményes világidő (UTC) dátum- és idősztringje.

Feljegyzés

További információ az ISO 8601 formátumról: ISO 8601.

Visszatérési típusok

Aláírt egész számértéket ad vissza.

Példák

Az alábbi példák 2019. február 4., 16:00 (UTC) és 2018. március 5., 05:00 (UTC) összehasonlítása különböző dátum- és időrészek használatával.

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("dd", "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("dd", "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,
    "diffPastDays": -336,
    "diffPastHours": -8075,
    "diffPastSeconds": -29070000,
    "diffFutureYears": 1,
    "diffFutureMonths": 11,
    "diffFutureDays": 336,
    "diffFutureHours": 8075,
    "diffFutureSeconds": 29070000
  }
]

Megjegyzések

  • Ez a függvény a következő okokból tér vissza undefined :
    • A megadott dátum- és időrész érvénytelen.
    • A kezdő vagy záró argumentumban szereplő dátum és idő nem érvényes ISO 8601 dátum- és idősztring.
  • Az ISO 8601 dátumformátum a függvényhez használandó érvényes dátum- és időrészeket adja meg: | | Formátum | | --- | --- | | Nap | day, dd| d | Óra | hour, hh | | Perc | minute, mi| n | Második | second, ss| s | Ezredmásodperc | millisecond, ms | | Mikroszekundum | microsecond, mcs | | Nanosecond | nanosecond, ns |
  • A függvény mindig egy aláírt egész számot ad vissza. A függvény a megadott dátum- és időrészre keresztelt határok számának mérését adja vissza, nem pedig az időintervallum mérését.

Kapcsolódó tartalom