DATETIMEADD - Lekérdezési nyelv a Cosmos DB-ben (az Azure-ban és a Fabricben)

A DATETIMEADD függvény 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.

Szemantika

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

Arguments

	Description
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.

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

Ez a szakasz példákat tartalmaz a lekérdezési nyelv szerkezetének használatára.

Dátumrészek hozzáadása és kivonása

Ebben a példában a függvény az DATETIMEADD évek, hónapok, napok és órák dátumból való hozzáadására és kivonására szolgál.

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

• 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 |
• 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.