你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
datetime_add()
适用于：✅Microsoft Fabric✅Azure 数据资源管理器Azure Monitor✅Microsoft✅ Sentinel
通过以下方法计算新的日期/时间：将指定的时间段乘以指定的数量，然后将指定的日期/时间加上或减去该乘积。
语法
datetime_add(period,amount,datetime)
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 描述 |
|---|---|---|---|
| period | string |
✔️ | 要递增的时间长度。 |
| amount | int |
✔️ | 要将 datetime 加上或减去的 period 的数目。 |
| datetime | datetime |
✔️ | 要按 period x amount 计算结果递增的日期。 |
period 的可能值：
- Year
- Quarter
- Month
- Week
- 日期
- Hour
- Minute
- Second
- Millisecond
- Microsecond
- Nanosecond
返回
加上特定的时间/日期间隔后的日期/时间。
示例
周期
print year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))
输出
| year | quarter | 月份 | week | day | hour | minute | 第 2 个 |
|---|---|---|---|---|---|---|---|
| 2018-01-01 00:00:00.0000000 | 2017-04-01 00:00:00.0000000 | 2017-02-01 00:00:00.0000000 | 2017-01-08 00:00:00.0000000 | 2017-01-02 00:00:00.0000000 | 2017-01-01 01:00:00.0000000 | 2017-01-01 00:01:00.0000000 | 2017-01-01 00:00:01.0000000 |
金额
print year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))
输出
| year | quarter | 月份 | week |
|---|---|---|---|
| 2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |