本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# addDateTime
<a name="addDateTime-function"></a>

`addDateTime` 會從日期時間值加上或減去某個單位的時間。例如，`addDateTime(2,'YYYY',parseDate('02-JUL-2018', 'dd-MMM-yyyy') )` 傳回 `02-JUL-2020`。您可以使用此函數對您的日期和時間資料執行日期數學。

## 語法
<a name="addDateTime-function-syntax"></a>

```
addDateTime(amount, period, datetime)
```

## 引數
<a name="addDateTime-function-arguments"></a>

 *amount*   
正數或負整數值，代表您要從提供的日期時間欄位加上或減去的時間量。

 *period*   
正數或負數值，代表您要從提供的日期時間欄位加上或減去的時間量。有效的期間如下：  
+ YYYY：這會傳回日期的年份部分。
+ Q：這會傳回日期所屬的季別 (1–4)。
+ MM：這會傳回日期的月份部分。
+ DD：這會傳回日期的日部分。
+ WK：這會傳回日期的週部分。本週從 Amazon Quick 的星期日開始。
+ HH：這會傳回日期的小時部分。
+ MI：這會傳回日期的分鐘部分。
+ SS：這會傳回日期的秒部分。
+ MS：這會傳回日期的毫秒部分。

 *datetime*   
您想要執行日期數學的日期或時間。

## 傳回類型
<a name="addDateTime-function-return-type"></a>

日期時間

## 範例
<a name="addDateTime-function-example"></a>

假設您有一個名為 `purchase_date` 的欄位，它有以下值。

```
2018 May 13 13:24
2017 Jan 31 23:06
2016 Dec 28 06:45
```

使用以下計算，`addDateTime` 會如下所示修改值。

```
addDateTime(-2, 'YYYY', purchaseDate)

2016 May 13 13:24
2015 Jan 31 23:06
2014 Dec 28 06:45


addDateTime(4, 'DD', purchaseDate)

2018 May 17 13:24
2017 Feb 4 23:06
2017 Jan 1 06:45


addDateTime(20, 'MI', purchaseDate)

2018 May 13 13:44
2017 Jan 31 23:26
2016 Dec 28 07:05
```