DateTimeAdd(NoSQL 쿼리)
적용 대상: 
NoSQL
지정된 숫자 값을 제공된 날짜 및 시간 문자열에 추가한 결과인 날짜 및 시간 문자열 값을 반환합니다.
구문
DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)
인수
| 설명 | |
|---|---|
date_time_part |
ISO 8601 날짜 형식 사양의 일부를 나타내는 문자열입니다. 이 부분은 관련 숫자 식에 의해 수정할 날짜의 측면을 나타내는 데 사용됩니다. |
numeric_expr |
부호 있는 정수로 표시되는 숫자 식입니다. |
date_time |
ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 UTC(협정 세계시) 날짜 및 시간 문자열입니다. |
참고 항목
ISO 8601형식에 대한 자세한 내용은 ISO 8601을 참조하세요.
반환 형식
ISO 8601 형식(YYYY-MM-DDThh:mm:ss.fffffffZ)으로 UTC 날짜 및 시간 문자열을 반환합니다.
예제
다음 예제에서는 2020년 7월 3일자정(UTC 00:00)에 다양한 값(1년, 1개월, 1일, 1시간)을 추가합니다. 또한 이 예제에서는 동일한 날짜에서 다양한 값(2년, 2개월, 2일, 2시간)을 뺍니다. 마지막으로 이 예제에서는 식을 사용하여 동일한 날짜의 초를 수정합니다.
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,yyyy,yy| | 월 |month,mm,m| | 일 |day,dd,d| | 시간 |hour,hh| | 분 |minute,mi,n| | 초 |second,ss,s| | 밀리초 |millisecond,ms| | 마이크로초 |microsecond,mcs| | 나노초 |nanosecond,ns|