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

DateTimeAdd (NoSQL-lekérdezés)

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Egy dátum- és idősztring-értéket ad vissza, amely egy megadott számértéknek a megadott dátum- és idősztringhez való hozzáadásának eredménye.

Syntax

DateTimeAdd(<date_time_part>, <numeric_expr> ,<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 azt jelzi, hogy a dátum mely aspektusát módosítsa a kapcsolódó numerikus kifejezés.
numeric_expr Egy numerikus kifejezés, amely aláírt egész számot eredményez.
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

EGY UTC dátum- és idősztringet ad vissza ISO 8601 formátumban YYYY-MM-DDThh:mm:ss.fffffffZ.

Példák

Az alábbi példa különböző értékeket (egy év, egy hónap, egy nap, egy óra) ad hozzá a 2020. július 3-i dátumhoz éjfélkor (UTC 00:00). A példa a különböző értékeket (két év, két hónap, két nap, két óra) is kivonja ugyanabból a dátumból. Végül ez a példa egy kifejezéssel módosítja ugyanannak a dátumnak a másodpercét.

SELECT VALUE {
    addOneYear: DateTimeAdd("yyyy", 1, "2020-07-03T00:00:00.0000000"),
    addOneMonth: DateTimeAdd("mm", 1, "2020-07-03T00:00:00.0000000"),
    addOneDay: DateTimeAdd("dd", 1, "2020-07-03T00:00:00.0000000"),
    addOneHour: DateTimeAdd("hh", 1, "2020-07-03T00:00:00.0000000"),
    subtractOneYear: DateTimeAdd("yyyy", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneMonth: DateTimeAdd("mm", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneDay: DateTimeAdd("dd", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneHour: DateTimeAdd("hh", -1, "2020-07-03T00:00:00.0000000"),
    modifySecondsExpression: DateTimeAdd("ss", 5 * -5, "2020-07-03T00:00:00.0000000")
}

[
  {
    "addOneYear": "2021-07-03T00:00:00.0000000Z",
    "addOneMonth": "2020-08-03T00:00:00.0000000Z",
    "addOneDay": "2020-07-04T00:00:00.0000000Z",
    "addOneHour": "2020-07-03T01:00:00.0000000Z",
    "subtractOneYear": "2019-07-03T00:00:00.0000000Z",
    "subtractOneMonth": "2020-06-03T00:00:00.0000000Z",
    "subtractOneDay": "2020-07-02T00:00:00.0000000Z",
    "subtractOneHour": "2020-07-02T23:00:00.0000000Z",
    "modifySecondsExpression": "2020-07-02T23:59:35.0000000Z"
  }
]

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 numerikus kifejezés nem érvényes egész szám.
    • Az 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 | | --- | --- | | Év | year, yyyy| yy | Hónap | month, mm| m | 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 |

Kapcsolódó tartalom