Udostępnij za pośrednictwem

DateTimeAdd (zapytanie NoSQL)

  • Artykuł

DOTYCZY: NoSQL

Zwraca wartość ciągu daty i godziny, która jest wynikiem dodania określonej wartości liczbowej do podanego ciągu daty i godziny.

Składnia

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

Argumenty

opis
date_time_part Ciąg reprezentujący część specyfikacji formatu daty ISO 8601. Ta część służy do wskazywania, który aspekt daty ma być modyfikowany przez powiązane wyrażenie liczbowe.
numeric_expr Wyrażenie liczbowe, które powoduje podpisanie liczby całkowitej.
date_time Ciąg daty i godziny koordynowanego czasu uniwersalnego (UTC) w formacie YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

Uwaga

Aby uzyskać więcej informacji na temat formatu ISO 8601, zobacz ISO 8601.

Typy zwracane

Zwraca ciąg daty i godziny UTC w formacie YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Przykłady

W poniższym przykładzie dodano różne wartości (jeden rok, miesiąc, jeden dzień, godzinę) do daty 3 lipca 2020 r. o północy (00:00 UTC). W przykładzie odejmuje się również różne wartości (dwa lata, dwa miesiące, dwa dni, dwie godziny) z tej samej daty. Na koniec w tym przykładzie użyto wyrażenia , aby zmodyfikować sekundy tej samej daty.

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

Uwagi

  • Ta funkcja zwraca undefined następujące przyczyny:
    • Określona część daty i godziny jest nieprawidłowa.
    • Wyrażenie liczbowe nie jest prawidłową liczbą całkowitą.
    • Data i godzina w argumencie nie są prawidłowym ciągiem daty i godziny ISO 8601.
  • Format daty ISO 8601 określa prawidłowe części daty i godziny do użycia z tą funkcją: | | Format | | --- | --- | | Rok | year, yyyy, yy | | Miesiąc | month, mm, m | | Dzień | day, dd, d | | Godzina | hour, hh | | Minuta | minute, mi, n | | Drugi | second, ss, s | | Milisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundy | nanosecond, ns |

Powiązana zawartość