适用范围：
NoSQL
返回一个日期/时间字符串，表示当前 UTC 时间减去指定的数值偏移量。
Syntax
AGO(<date_time_part>, <numeric_expr>)
Arguments
| Description | |
|---|---|
date_time_part |
表示 ISO 8601 日期格式规范的一部分的字符串。 此部分用于指示要由相关数值表达式修改的日期的哪个方面。 |
numeric_expr |
要从当前日期时间减去的值。 |
返回类型
返回字符串表达式。
例子
以下示例显示了具有不同时间部分的 AGO 函数的各种用法。 假定当前日期时间为 2024-10-14T14：20：30.66688888Z。
SELECT VALUE {
"case1": AGO("yyyy", 1),
"case2": AGO("yyyy", -1),
"case3": AGO("ss", 30),
"case4": AGO("ms", 4)
}
[
{
"case1": "2023-10-14T14:20:30.6668888Z",
"case2": "2025-10-14T14:20:30.6668888Z",
"case3": "2024-10-14T14:20:00.6668888Z",
"case4": "2024-10-14T14:20:30.6628888Z"
}
]
注解
- ISO 8601 日期格式指定要用于此函数的有效日期和时间部分：
- 年份：year、yyyy、y
- 月：月、mm、m
- Day：day、dd、d
- 小时：小时、hh
- 分钟：分钟、mi、n
- Second： second， ss， s
- 毫秒：毫秒、毫秒
- 微秒：微秒、mcs
- Nanosecond：nanosecond、ns