Бөлісу құралы:

DateTimeAdd (запрос NoSQL)

  • Мақала

ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL

Возвращает значение строки даты и времени, которое является результатом добавления указанного значения числа в указанную строку даты и времени.

Синтаксис

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

Аргументы

Description
date_time_part Строка, представляющая часть спецификации формата даты ISO 8601. Эта часть используется для указания аспекта даты изменения соответствующим числовым выражением.
numeric_expr Числовое выражение, в результате чего целое число со знаком.
date_time Строка даты и времени (UTC) в формате YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

Примечание.

Дополнительные сведения о формате ISO 8601 см . в статье ISO 8601.

Типы возвращаемых данных

Возвращает строку даты и времени UTC в формате YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

Примеры

В следующем примере добавляются различные значения (один год, один месяц, один день, один час) к дате 3 июля 2020 г. в полночь (00:00 UTC). В примере также вычитается различные значения (два года, два месяца, два дня, два часа) из одной даты. Наконец, в этом примере используется выражение для изменения секунд одной даты.

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

Замечания

  • Эта функция возвращается undefined по следующим причинам:
    • Указанная часть даты и времени недопустимая.
    • Числовое выражение не является допустимым целым числом.
    • Дата и время в аргументе не является допустимой строкой даты и времени ISO 8601.
  • Формат даты ISO 8601 указывает допустимые части даты и времени, используемые с этой функцией: | | Формат | | --- | --- | | Year | year, yyyyyy | | Месяц | month, mmm | | День | day, ddd | | Час | hour, hh | | Minute | minute, min | | Во-вторых | second, sss | | Миллисекунда | millisecond, ms | | Microsecond | microsecond, mcs | | Nanosecond | nanosecond,ns |

Связанный контент