DateTimeAdd (NoSQL-fråga)

  • Artikel

GÄLLER FÖR: NoSQL

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

Argument

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

Kommentar

Mer information om FORMATET ISO 8601 finns i ISO 8601.

Returtyper

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

Exempel

I följande exempel läggs olika värden (ett år, en månad, en dag, en timme) till datumet 3 juli 2020 vid midnatt (00:00 UTC). Exemplet subtraherar också olika värden (två år, två månader, två dagar, två timmar) från samma datum. Slutligen använder det här exemplet ett uttryck för att ändra sekunderna för samma 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"
  }
]

Kommentarer

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

Relaterat innehåll