你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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、yyyy、yy | | 月 | month、mm、m | | 日 | day、dd、d | | 小时 | hour、hh | | 分 | minute、mi、n | | 秒 | second、ss、s | | 毫秒 | millisecond、ms | | 微秒 | microsecond、mcs | | 纳秒 | nanosecond、ns |

相关内容