共用方式為

DATETIMEADD - Cosmos DB 中的查詢語言 （在 Azure 和 Fabric 中）

  • 適用於: ✅ 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， yyyy， | yy |月 | month， mm， | m |日 | day， dd， | d |小時 | hour， hh | |分鐘 | minute， mi， | n |第二 | second，ss，| s |毫秒 | millisecond， ms | |微秒 | microsecond， mcs | |納秒 | nanosecond，ns |
  • 此函式會傳回 undefined ，原因如下：
    • 指定的日期和時間部分無效。
    • 數值運算式不是有效的整數。
    • 引數中的日期和時間不是有效的 ISO 8601 日期和時間字串。
  • Last updated on