DateTimeFromParts(NoSQL 쿼리)
적용 대상: NoSQL
다양한 날짜 및 시간 파트에 대한 입력 숫자 값으로 생성된 날짜 및 시간 문자열 값을 반환합니다.
구문
DateTimeFromParts(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>] [, <numeric_minute>] [, <numeric_second>] [, <numeric_second_fraction>])
인수
설명 | |
---|---|
numeric_year |
연도의 양수 정수 값입니다. 이 인수는 ISO 8601 형식 yyyy 입니다. |
numeric_month |
월의 양수 정수 값입니다. 이 인수는 ISO 8601 형식 mm 입니다. |
numeric_day |
일의 양수 정수 값입니다. 이 인수는 ISO 8601 형식 dd 입니다. |
numeric_hour (선택 사항) |
시간에 대한 선택적 양의 숫자 정수 값입니다. 이 인수는 ISO 8601 형식 hh 입니다. 지정하지 않으면 기본값 0 입니다. |
numeric_minute (선택 사항) |
분에 대한 선택적 양의 숫자 정수 값입니다. 이 인수는 ISO 8601 형식 mm 입니다. 지정하지 않으면 기본값 0 입니다. |
numeric_second (선택 사항) |
초에 대한 선택적 양의 숫자 정수 값입니다. 이 인수는 ISO 8601 형식 ss 입니다. 지정하지 않으면 기본값 0 입니다. |
numeric_second_fraction (선택 사항) |
소수 자릿수 초에 대한 선택적 양의 숫자 정수 값입니다. 이 인수는 ISO 8601 형식 fffffffZ 입니다. 지정하지 않으면 기본값 0 입니다. |
참고 항목
ISO 8601형식에 대한 자세한 내용은 ISO 8601을 참조하세요.
반환 형식
ISO 8601 형식(YYYY-MM-DDThh:mm:ss.fffffffZ
)으로 UTC 날짜 및 시간 문자열을 반환합니다.
예제
다음 예제에서는 다양한 인수 조합을 사용하여 날짜 및 시간 문자열을 만듭니다. 이 예제에서는 2017년 4월 20일 13:15 UTC 날짜와 시간을 사용합니다.
SELECT VALUE {
constructMinArguments: DateTimeFromParts(2017, 4, 20),
constructMinEquivalent: DateTimeFromParts(2017, 4, 20, 0, 0, 0, 0),
constructAllArguments: DateTimeFromParts(2017, 4, 20, 13, 15, 20, 3456789),
constructPartialArguments: DateTimeFromParts(2017, 4, 20, 13, 15),
constructInvalidArguments: DateTimeFromParts(-2000, -1, -1)
}
[
{
"constructMinArguments": "2017-04-20T00:00:00.0000000Z",
"constructMinEquivalent": "2017-04-20T00:00:00.0000000Z",
"constructAllArguments": "2017-04-20T13:15:20.3456789Z",
"constructPartialArguments": "2017-04-20T13:15:00.0000000Z"
}
]
설명
- 지정된 정수에서 잘못된 날짜와 시간을 만들면 함수는
undefined
를 반환합니다.