Share via

DateTimeAdd (NoSQL-Abfrage)

  • Artikel

GILT FÜR: NoSQL

Gibt einen Datums- und Uhrzeitzeichenfolgenwert zurück, der das Ergebnis des Hinzufügens eines angegebenen Zahlenwerts zur angegebenen Datums- und Uhrzeitzeichenfolge ist.

Syntax

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

Argumente

BESCHREIBUNG
date_time_part Eine Zeichenfolge, die einen Teil einer Datumsformatspezifikation im ISO 8601-Format darstellt. Dieser Teil wird verwendet, um anzugeben, welcher Aspekt des Datums durch den zugehörigen numerischen Ausdruck geändert werden soll.
numeric_expr Ein numerischer Ausdruck, der eine ganze Zahl mit Vorzeichen ergibt.
date_time Eine Datums- und Uhrzeitzeichenfolge in UTC (Coordinated Universal Time, koordinierte Weltzeit) im ISO 8601-Format YYYY-MM-DDThh:mm:ss.fffffffZ.

Hinweis

Weitere Informationen zum ISO 8601-Format finden Sie unter ISO 8601.

Rückgabetypen

Gibt eine Datums- und Uhrzeitzeichenfolge im ISO 8601-Format YYYY-MM-DDThh:mm:ss.fffffffZ zurück.

Beispiele

Im folgenden Beispiel werden dem Datum 3. Juli 2020 um Mitternacht (00:00 Uhr UTC) verschiedene Werte (ein Jahr, ein Monat, ein Tag, eine Stunde) hinzugefügt. Das Beispiel subtrahiert auch verschiedene Werte (zwei Jahre, zwei Monate, zwei Tage, zwei Stunden) vom selben Datum. Schließlich wird in diesem Beispiel ein Ausdruck verwendet, um die Sekunden desselben Datums zu ändern.

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

Bemerkungen

  • Diese Funktion gibt aus folgenden Gründen undefined zurück:
    • Der angegebene Teil von Datum und Uhrzeit ist ungültig.
    • Der numerische Ausdruck ist keine gültige ganze Zahl.
    • Das Datum und die Uhrzeit im Argumenten sind keine gültigen Datums- und Uhrzeitzeichenfolgen im ISO 8601-Format.
  • Das ISO 8601-Datumsformat gibt gültige Datums- und Uhrzeitteile an, die mit dieser Funktion verwendet werden sollen: | | Format | | --- | --- | | Jahr | year, yyyy, yy | | Monat | month, mm, m | | Tag | day, dd, d | | Stunde | hour, hh | | Minute | minute, mi, n | | Sekunde | second, ss, s | | Millisekunde | millisecond, ms | | Mikrosekunde | microsecond, mcs | | Nanosekunde | nanosecond, ns |

Verwandter Inhalt