datetime_add()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
從指定的期間計算新的 日期時間 ,乘以指定的數量、加入或從指定的 日期時間減去。
語法
datetime_add(
期間,
金額,
日期時間)
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
時期 | string |
✔️ | 要遞增的時間長度。 |
金額 | int |
✔️ | 要加入或減去日期時間的期間數。 |
datetime | datetime |
✔️ | 要依期間 x 金額計算結果遞增的日期。 |
週期的可能值:
- Year
- 季
- 月
- 週
- Day
- Hour
- Minute
- 第二個
- Millisecond
- 微秒
- 奈秒
傳回
範例
期間
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 | month | 週 | 天 | hour | 分鐘 | second |
---|---|---|---|---|---|---|---|
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 | month | 週 |
---|---|---|---|
2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |