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 格式 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
|