DATETIMEADD – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen DATETIMEADD returnerar ett datum- och tidssträngsvärde som är resultatet av att lägga till ett angivet talvärde i den angivna datum- och tidssträngen.

Syntax

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

Arguments

	Description
date_time_part	En sträng som representerar en del av en ISO 8601-datumformatspecifikation. Den här delen används för att ange vilken aspekt av datumet som ska ändras av det relaterade numeriska uttrycket.
numeric_expr	Ett numeriskt uttryck som resulterar i ett signerat heltal.
date_time	En utc-datum- och tidssträng (Coordinated Universal Time) i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Returtyper

Returnerar en UTC-datum- och tidssträng i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Lägga till och subtrahera datumdelar

I det här exemplet DATETIMEADD används funktionen för att lägga till och subtrahera år, månader, dagar och timmar från ett datum.

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

Anmärkningar

• Datumformatet ISO 8601 anger giltiga datum- och tidsdelar som ska användas med den här funktionen: | | Format | | --- | --- | | År | year, yyyy, yy | | Månad | month, mm, m | | Dag | day, dd, d | | Timme | hour, hh | | Minut | minute, mi, n | | För det andra | second , sss | | Millisekunder | millisecond| ms | | Mikrosekunder | microsecond| mcs | | Nanosekunder | nanosecond,ns |
• Den här funktionen returnerar undefined av följande skäl:
  • Den angivna datum- och tidsdelen är ogiltig.
  • Det numeriska uttrycket är inte ett giltigt heltal.
  • Datum och tid i argumentet är inte en giltig DATUM- och tidssträng för ISO 8601.