DateTimeBin(NoSQL 쿼리)
적용 대상: 
NoSQL
제공된 날짜 및 시간 문자열의 일부를 범주화(또는 반올림)한 결과인 날짜 및 시간 문자열 값을 반환합니다.
구문
DateTimeBin(<date_time> , <date_time_part> [, <bin_size>] [, <bin_start_date_time>])
인수
| 설명 | |
|---|---|
date_time |
ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 UTC(협정 세계시) 날짜 및 시간 문자열입니다. |
date_time_part |
ISO 8601 날짜 형식 사양의 일부를 나타내는 문자열입니다. 이 부분은 날짜의 어느 부분을 범주화할지 나타내는 데 사용됩니다. 특히 이 파트 인수는 범주화(또는 반올림)의 세분성 수준을 나타냅니다. 파트의 최소 세분성은 일이며 최대 세분성은 나노초입니다. |
bin_size(선택 사항) |
계급구간의 크기를 지정하는 선택적 숫자 값입니다. 지정하지 않으면 기본값 1입니다. |
bin_start_date_time(선택 사항) |
ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 선택적 UTC(협정 세계시) 날짜 및 시간 문자열입니다. 이 날짜 및 시간 인수는 범주화할 시작 날짜를 지정합니다. 지정하지 않으면 기본값은 Unix epoch 1970-01-01T00:00:00.000000Z입니다. |
반환 형식
ISO 8601 형식(YYYY-MM-DDThh:mm:ss.fffffffZ)으로 UTC 날짜 및 시간 문자열을 반환합니다.
예제
다음 예에서는 날짜 2021년 1월 8일18:35 UTC를 다양한 값으로 범주화합니다. 이 예제에서는 계급구간 크기 및 계급구간 시작 날짜 및 시간도 변경합니다.
SELECT VALUE {
binDay: DateTimeBin("2021-01-08T18:35:00.0000000", "dd"),
binHour: DateTimeBin("2021-01-08T18:35:00.0000000", "hh"),
binSecond: DateTimeBin("2021-01-08T18:35:00.0000000", "ss"),
binFiveHours: DateTimeBin("2021-01-08T18:35:00.0000000", "hh", 5),
binSevenDaysUnixEpoch: DateTimeBin("2021-01-08T18:35:00.0000000", "dd", 7),
binSevenDaysWindowsEpoch: DateTimeBin("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}
[
{
"binDay": "2021-01-08T00:00:00.0000000Z",
"binHour": "2021-01-08T18:00:00.0000000Z",
"binSecond": "2021-01-08T18:35:00.0000000Z",
"binFiveHours": "2021-01-08T15:00:00.0000000Z",
"binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
"binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
}
]
설명
- 이 함수는 다음과 같은 이유로 반환
undefined됩니다.- 지정된 날짜 및 시간 파트가 잘못되었습니다.
- 계급구간 크기 값이 유효한 정수가 아니거나, 0이거나, 음수입니다.
- 두 인수 중 하나의 날짜 및 시간이 유효한 ISO 8601 날짜 및 시간 문자열이 아닙니다.
- 계급구간 시작 날짜 및 시간이 Windows epoch인
1601년 이전입니다.
- ISO 8601 날짜 형식은 이 함수에 사용할 유효한 날짜 및 시간 파트를 지정합니다. | | 형식 | | --- | --- | | 일 |
day,dd,d| | 시간 |hour,hh| | 분 |minute,mi,n| | 초 |second,ss,s| | 밀리초 |millisecond,ms| | 마이크로초 |microsecond,mcs| | 나노초 |nanosecond,ns|