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

DateTimeAdd (NoSQL-lekérdezés)

  • Cikk

A KÖVETKEZŐKRE VONATKOZIK: NoSQL

Egy dátum- és idősztring-értéket ad vissza, amelynek eredménye egy megadott számérték hozzáadása a megadott dátum- és idősztringhez.

Szintaxis

DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)

Argumentumok

Description
date_time_part Az ISO 8601 dátumformátum-specifikáció egy részét képviselő sztring. Ez a rész azt jelzi, hogy a dátum mely aspektusát kell módosítani a kapcsolódó numerikus kifejezéssel.
numeric_expr Egy numerikus kifejezés, amely egy aláírt egész számot eredményez.
date_time Egyezményes világidő (UTC) dátum- és idősztring ISO 8601 formátumban YYYY-MM-DDThh:mm:ss.fffffffZ.

Megjegyzé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. éjféli dátumhoz (UTC 00:00). A példa különböző értékeket (két év, két hónap, két nap, két óra) is kivon 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 ad undefined vissza:
    • 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 | | Mikroszekron, | microsecondmcs | | Nanosecond | nanosecond,ns |

Kapcsolódó tartalom