共用方式為

DateTimeAdd （NoSQL 查詢）

  • 發行項

適用於：NoSQL

傳回日期和時間字串值，這是將指定數位值加入所提供日期和時間字串的結果。

語法

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

引數

描述
date_time_part 字串，表示 ISO 8601 日期格式規格的一部分。 這個部分用來指出相關數值表達式要修改的日期層面。
numeric_expr 數值表達式，產生帶正負號的整數。
date_time ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的國際標準時間 （UTC） 日期和時間字串。

注意

如需 ISO 8601 格式的詳細資訊，請參閱 ISO 8601。

傳回類型

傳回 ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ的 UTC 日期和時間字串。

範例

下列範例會將各種值（一年、一個月、一天、一小時）新增至 2020 年 7 月 3 日午夜 （00：00 UTC） 的日期。 此範例也會從相同日期減去各種值（兩年、兩個月、兩天、兩小時）。 最後，這個範例會使用表達式來修改相同日期的秒數。

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"
  }
]

備註

  • 此函式會基於下列原因傳回 undefined ：
    • 指定的日期和時間部分無效。
    • 數值表達式不是有效的整數。
    • 自變數中的日期和時間不是有效的 ISO 8601 日期和時間字串。
  • ISO 8601 日期格式會指定要搭配此函式使用的有效日期和時間部分： | |格式 | |--- |--- | | Year | year、 yyyy、 yy | | Month | month、 mm、 m | | Day | day、 dd、 d | | Hour | hour、 hh | | Minute | minute、 mi、 n | | 第二 | second個、 ss、 s | | 毫秒 | millisecond、 ms | | Microsecond | microsecond、 mcs | | Nanosecond | nanosecond， ns |

相關內容