DATETIMEADD – Dotazovací jazyk ve službě Cosmos DB (v Azure a prostředcích infrastruktury)

Funkce DATETIMEADD vrátí hodnotu řetězce data a času, která je výsledkem přidání zadané číselné hodnoty k zadanému řetězci data a času.

Syntaxe

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

Arguments

	Description
date_time_part	Řetězec představující část specifikace formátu data ISO 8601. Tato část slouží k označení, který aspekt data se má upravit souvisejícím číselným výrazem.
numeric_expr	Číselný výraz, který má za následek celé číslo se dvěma čísly.
date_time	Řetězec data a času koordinovaného univerzálního času (UTC) ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Návratové typy

Vrátí řetězec data a času UTC ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Examples

Tato část obsahuje příklady použití tohoto konstruktoru dotazovacího jazyka.

Sčítání a odečítání částí kalendářních dat

V tomto příkladu se DATETIMEADD funkce používá k sčítání a odčítání roků, měsíců, dnů a hodin od data.

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"
  }
]

Poznámky

• Formát data ISO 8601 určuje platné části data a času, které se mají použít s touto funkcí: | | Formát | | --- | --- | | Rok | year, | yyyyyy| Month | month, , mmm| | Den | day, | ddd| Hodina | hour, hh | | Minuta | minute, | min | Sekunda | second, | sss | Milisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundová | nanosecondns |
• Tato funkce se vrátí undefined z těchto důvodů:
  • Zadaná část data a času je neplatná.
  • Číselný výraz není platné celé číslo.
  • Datum a čas v argumentu není platným řetězcem data a času ISO 8601.