從指定的期間計算新的 日期時間 ，乘以指定的數量、加入或從指定的 日期時間減去。
語法
datetime_add(
期間,金額,日期時間)
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| 時期 | string |
✔️ | 要遞增的時間長度。 |
| 金額 | int |
✔️ | 要加入或減去日期時間的期間數。 |
| datetime | datetime |
✔️ | 要依期間 x 金額計算結果遞增的日期。 |
週期的可能值：
- 年
- 季
- 月
- 週
- 日
- 小時
- 分鐘
- 第二個
- 毫秒
- 微秒
- 奈秒
傳回
傳回加入特定時間/日期間隔之後的日期 時間 。
範例
下列範例示範如何使用 函式，將句點新增至 datetime 值 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))
輸出
| 年 | 季度 | 月份 | 週 | 天 | 小時 | 分鐘 | 秒 |
|---|---|---|---|---|---|---|---|
| 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 |