Sdílet prostřednictvím

DateTimeAdd (dotaz NoSQL)

  • Článek

PLATÍ PRO: NoSQL

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>)

Argumenty

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

Poznámka:

Další informace o formátu ISO 8601 naleznete v tématu ISO 8601.

Návratové typy

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

Příklady

Následující příklad přidá různé hodnoty (jeden rok, jeden měsíc, jeden den, hodinu) k datu 3. července 2020 o půlnoci (00:00 UTC). Příklad také odečte různé hodnoty (dva roky, dva měsíce, dva dny, dvě hodiny) od stejného data. Nakonec tento příklad používá výraz k úpravě sekund stejného 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

  • 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.
  • Formát data ISO 8601 určuje platné části data a času, které se mají použít s touto funkcí: | | Formát | | --- | --- | | Rok | year, | yy yyyy| Month | month, , m mm| | Den | day, | d | ddHodina | hour, hh | | Minuta | minute, | | minSekunda | second, | | sssMilisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundová | nanosecondns |

Související obsah