Delen via

DateTimeAdd (NoSQL-query)

  • Artikel

VAN TOEPASSING OP: NoSQL

Retourneert een datum- en tijdtekenreekswaarde die het resultaat is van het toevoegen van een opgegeven getalwaarde aan de opgegeven datum- en tijdtekenreeks.

Syntaxis

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

Argumenten

Beschrijving
date_time_part Een tekenreeks die een deel van een ISO 8601-datumnotatiespecificatie vertegenwoordigt. Dit onderdeel wordt gebruikt om aan te geven welk aspect van de datum moet worden gewijzigd door de gerelateerde numerieke expressie.
numeric_expr Een numerieke expressie die resulteert in een ondertekend geheel getal.
date_time Een UTC-datum- en tijdtekenreeks (Coordinated Universal Time) in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.

Notitie

Zie ISO 8601 voor meer informatie over de ISO 8601-indeling.

Retourtypen

Retourneert een UTC-datum- en tijdtekenreeks in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.

Voorbeelden

In het volgende voorbeeld worden verschillende waarden (één jaar, één maand, één dag, één uur) toegevoegd aan de datum 3 juli 2020 om middernacht (00:00 UTC). In het voorbeeld worden ook verschillende waarden (twee jaar, twee maanden, twee dagen, twee uur) van dezelfde datum afgetrokken. Ten slotte gebruikt dit voorbeeld een expressie om de seconden van dezelfde datum te wijzigen.

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

Opmerkingen

  • Deze functie retourneert undefined om deze redenen:
    • Het opgegeven datum- en tijdgedeelte is ongeldig.
    • De numerieke expressie is geen geldig geheel getal.
    • De datum en tijd in het argument zijn geen geldige ISO 8601-datum- en tijdtekenreeks.
  • De ISO 8601-datumnotatie geeft geldige datum- en tijdonderdelen op die moeten worden gebruikt met deze functie: | | Opmaak | | --- | --- | | Jaar | year, yyyyyy | | Maand | month, mmm | | Dag | day, ddd | | Uur | hour, hh | | Minuut | minute, min | | Tweede | second, sss | | Milliseconden | millisecond, ms | Microseconde | microsecond, mcs | | Nanoseconden | nanosecond,ns |

Gerelateerde inhoud