다음을 통해 공유


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를 반환합니다.