다음을 통해 공유

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 |
  • 이 함수는 인덱스를 사용하지 않습니다.

관련 콘텐츠