DateTimePart(NoSQL 쿼리)
적용 대상: 
NoSQL
제공된 날짜 및 시간에 대해 지정된 날짜 및 시간 부분의 값을 반환합니다.
구문
DateTimePart(<date_time_part> , <date_time>)
인수
| 설명 | |
|---|---|
date_time |
ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 UTC(협정 세계시) 날짜 및 시간 문자열입니다. |
date_time_part |
ISO 8601 날짜 형식 사양의 일부를 나타내는 문자열입니다. 이 부분은 추출하고 반환할 날짜의 부분을 나타내는 데 사용됩니다. |
참고 항목
ISO 8601형식에 대한 자세한 내용은 ISO 8601을 참조하세요.
반환 형식
양의 정수인 숫자 값을 반환합니다.
예제
다음 예제에서는 2016년 5월 29일 08:30 UTC 날짜 및 시간의 다양한 부분을 반환합니다.
SELECT VALUE {
getYear: DateTimePart("yyyy", "2016-05-29T08:30:00.1301617"),
getMonth: DateTimePart("mm", "2016-05-29T08:30:00.1301617"),
getDay: DateTimePart("dd", "2016-05-29T08:30:00.1301617"),
getHour: DateTimePart("hh", "2016-05-29T08:30:00.1301617"),
getMinute: DateTimePart("mi", "2016-05-29T08:30:00.1301617"),
getSecond: DateTimePart("ss", "2016-05-29T08:30:00.1301617"),
getMillisecond: DateTimePart("ms", "2016-05-29T08:30:00.1301617"),
getMicrosecond: DateTimePart("mcs", "2016-05-29T08:30:00.1301617"),
getNanosecond: DateTimePart("ns", "2016-05-29T08:30:00.1301617")
}
[
{
"getYear": 2016,
"getMonth": 5,
"getDay": 29,
"getHour": 8,
"getMinute": 30,
"getSecond": 0,
"getMillisecond": 130,
"getMicrosecond": 130161,
"getNanosecond": 130161700
}
]
설명
- 이 함수는 다음과 같은 이유로 반환
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| - 이 함수는 인덱스를 사용하지 않습니다.