翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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*   
正の値または負の整数値は、指定された日時フィールドに対して加算または減算する時間の量を表します。

 *期間*   
正の値または負の値は、指定された日時フィールドに対して加算または減算する時間の量を表します。有効な期間は次のとおりです。  
+ YYYY: 日付の年の部分を返します。
+ Q: 日付が属している四半期 (1～4) を返します。
+ MM: 日付の月の部分を返します。
+ DD: 日付の日の部分を返します。
+ WK: 日付の週の部分を返します。Amazon Quick の週は日曜日から始まります。
+ HH: 日付の時間の部分を返します。
+ MI: 日付の分の部分を返します。
+ SS: 日付の秒の部分を返します。
+ MS: 日付のミリ秒の部分を返します。

 *datetime*   
日付計算を実行する日付または時刻。

## 戻り型
<a name="addDateTime-function-return-type"></a>

Datetime

## 例
<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
```