通过

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

datetime_add（）

适用于：✅✅Azure 数据资源管理器Azure Monitor✅ Sentinel

通过以下方法计算新的日期/时间：将指定的时间段乘以指定的数量，然后将指定的日期/时间加上或减去该乘积。

语法

datetime_add(periodamount,datetime

详细了解语法约定。

参数

客户 类型​​ 必需 描述
时期 string ✔️ 要递增的时间长度。
金额 int ✔️ 要将 datetime 加上或减去的 period 的数目。
日期/时间 datetime ✔️ 要按 period x amount 计算结果递增的日期。

period 的可能值：

  • 年份
  • 季度
  • 月份
  • 周
  • 日期
  • 小时
  • 分钟
  • 第二个
  • 毫秒
  • 微秒
  • 纳秒

返回

返回添加特定时间/日期间隔后的 日期时间 。

示例

以下示例演示如何使用datetime_add函数将句点添加到日期/时间值。

运行查询

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))

输出

年 季度 月份 周 日 小时 分钟 第 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

下面的示例演示如何使用 datetime_add 函数从特定日期添加或减去时间间隔。

运行查询

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))

输出

年 季度 月份 周
2012-01-01T00：00：00Z 2020-01-01T00：00：00Z 2015-10-01T00：00：00Z 2018-12-02T00：00：00Z