datetime_add()

适用于:✅Azure 数据资源管理器Azure MonitorMicrosoft 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