DateTimeDiff(NoSQL 쿼리)
적용 대상: 
NoSQL
두 날짜와 시간 값 사이의 지정된 날짜 및 시간 파트의 차이를 부호 있는 정수로 반환합니다.
구문
DateTimeDiff(<date_time_part>, <start_date_time>, <end_date_time>)
인수
| 설명 | |
|---|---|
date_time_part |
ISO 8601 날짜 형식 사양의 일부를 나타내는 문자열입니다. 이 파트는 날짜의 어느 파트를 비교할지 나타내는 데 사용됩니다. |
start_date_time |
ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 UTC(협정 세계시) 날짜 및 시간 문자열입니다. |
end_date_time |
ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 UTC(협정 세계시) 날짜 및 시간 문자열입니다. |
참고 항목
ISO 8601형식에 대한 자세한 내용은 ISO 8601을 참조하세요.
반환 형식
부호 있는 정수인 숫자 값을 반환합니다.
예제
다음 예제에서는 다양한 날짜 및 시간 파트를 사용하여 2019년 2월 4일 16:00 UTC 및 2018년 3월 5일 05:00 UTC를 비교합니다.
SELECT VALUE {
diffPastYears: DateTimeDiff("yyyy", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
diffPastMonths: DateTimeDiff("mm", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
diffPastDays: DateTimeDiff("dd", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
diffPastHours: DateTimeDiff("hh", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
diffPastSeconds: DateTimeDiff("ss", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
diffFutureYears: DateTimeDiff("yyyy", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
diffFutureMonths: DateTimeDiff("mm", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
diffFutureDays: DateTimeDiff("dd", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
diffFutureHours: DateTimeDiff("hh", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
diffFutureSeconds: DateTimeDiff("ss", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000")
}
[
{
"diffPastYears": -1,
"diffPastMonths": -11,
"diffPastDays": -336,
"diffPastHours": -8075,
"diffPastSeconds": -29070000,
"diffFutureYears": 1,
"diffFutureMonths": 11,
"diffFutureDays": 336,
"diffFutureHours": 8075,
"diffFutureSeconds": 29070000
}
]
설명
- 이 함수는 다음과 같은 이유로 반환
undefined됩니다.- 지정된 날짜 및 시간 파트가 잘못되었습니다.
- start 또는 end 인수 중 하나의 날짜 및 시간이 유효한 ISO 8601 날짜 및 시간 문자열이 아닙니다.
- ISO 8601 날짜 형식은 이 함수에 사용할 유효한 날짜 및 시간 파트를 지정합니다. | | 형식 | | --- | --- | | 일 |
day,dd,d| | 시간 |hour,hh| | 분 |minute,mi,n| | 초 |second,ss,s| | 밀리초 |millisecond,ms| | 마이크로초 |microsecond,mcs| | 나노초 |nanosecond,ns| - 함수는 항상 부호 있는 정수 값을 반환합니다. 함수는 시간 간격의 측정값이 아니라 지정된 날짜 및 시간 파트에 대해 교차된 경계 수의 측정값을 반환합니다.