다음을 통해 공유

DATETIMEADD - Cosmos DB의 쿼리 언어(Azure 및 패브릭)

  • 적용 대상: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

이 함수는 DATETIMEADD 지정된 숫자 값을 제공된 날짜 및 시간 문자열에 추가한 결과인 날짜 및 시간 문자열 값을 반환합니다.

구문

DATETIMEADD(<date_time_part>, <numeric_expr>, <date_time>)

Arguments

Description
date_time_part ISO 8601 날짜 형식 사양의 일부를 나타내는 문자열입니다. 이 부분은 관련 숫자 식에서 수정할 날짜의 측면을 나타내는 데 사용됩니다.
numeric_expr 부호 있는 정수의 결과로 생성되는 숫자 식입니다.
date_time ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ의 UTC(협정 세계시) 날짜 및 시간 문자열입니다.

반환 형식

ISO 8601 형식 YYYY-MM-DDThh:mm:ss.fffffffZ으로 UTC 날짜 및 시간 문자열을 반환합니다.

예시

이 섹션에는 이 쿼리 언어 구문을 사용하는 방법에 대한 예제가 포함되어 있습니다.

날짜 부분 추가 및 빼기

이 예제 DATETIMEADD 에서 함수는 날짜에서 연도, 월, 일 및 시간을 추가하고 빼는 데 사용됩니다.

SELECT VALUE {
  addOneYear: DATETIMEADD("yyyy", 1, "2020-07-03T00:00:00.0000000"),
  addOneMonth: DATETIMEADD("mm", 1, "2020-07-03T00:00:00.0000000"),
  addOneDay: DATETIMEADD("dd", 1, "2020-07-03T00:00:00.0000000"),
  addOneHour: DATETIMEADD("hh", 1, "2020-07-03T00:00:00.0000000"),
  subtractOneYear: DATETIMEADD("yyyy", -1, "2020-07-03T00:00:00.0000000"),
  subtractOneMonth: DATETIMEADD("mm", -1, "2020-07-03T00:00:00.0000000"),
  subtractOneDay: DATETIMEADD("dd", -1, "2020-07-03T00:00:00.0000000"),
  subtractOneHour: DATETIMEADD("hh", -1, "2020-07-03T00:00:00.0000000"),
  modifySecondsExpression: DATETIMEADD("ss", 5 * -5, "2020-07-03T00:00:00.0000000")
}

[
  {
    "addOneYear": "2021-07-03T00:00:00.0000000Z",
    "addOneMonth": "2020-08-03T00:00:00.0000000Z",
    "addOneDay": "2020-07-04T00:00:00.0000000Z",
    "addOneHour": "2020-07-03T01:00:00.0000000Z",
    "subtractOneYear": "2019-07-03T00:00:00.0000000Z",
    "subtractOneMonth": "2020-06-03T00:00:00.0000000Z",
    "subtractOneDay": "2020-07-02T00:00:00.0000000Z",
    "subtractOneHour": "2020-07-02T23:00:00.0000000Z",
    "modifySecondsExpression": "2020-07-02T23:59:35.0000000Z"
  }
]

비고

  • ISO 8601 날짜 형식은 이 함수에 사용할 유효한 날짜 및 시간 부분을 지정합니다. | | 형식 | | --- | --- | | Year | year, yyyy, yy | | Month | month, mm, m | | Day | day, dd, d | | Hour | hour, hh | | Minute | minute, mi, n | | Second | second, ss, s | | 밀리초 | millisecond, ms | | 마이크로초 | microsecond, mcs | | Nanosecond | nanosecond,ns |
  • 이 함수는 다음과 같은 이유로 반환 undefined 됩니다.
    • 지정한 날짜 및 시간 부분이 잘못되었습니다.
    • 숫자 식은 유효한 정수가 아닙니다.
    • 인수의 날짜 및 시간은 유효한 ISO 8601 날짜 및 시간 문자열이 아닙니다.
  • Last updated on