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

# Amazon QLDB 中的 DATE\$1ADD 函數
DATE\$1ADD

**重要**  
支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱[將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。

在 Amazon QLDB 中，使用 `DATE_ADD`函數將指定的時間戳記值增加指定的間隔。

## 語法


```
DATE_ADD( datetimepart, interval, timestamp )
```

## 引數


*datetimepart*  
函數操作的日期或時間部分。此參數可為下列其中一個值：  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*間隔*  
指定要新增至指定*時間戳記*之間隔的整數。負整數會減去間隔。

*timestamp*  
函數遞增的資料類型欄位名稱或表達`timestamp`式。  
Ion 時間戳記常值可以用反引號 () 表示``...``。如需格式化詳細資訊和時間戳記值的範例，請參閱 Amazon Ion 規格文件中的[時間戳記](https://amzn.github.io/ion-docs/docs/spec.html#timestamp)。

## 傳回類型


`timestamp`

## 範例


```
DATE_ADD(year, 5, `2010-01-01T`)                -- 2015-01-01T
DATE_ADD(month, 1, `2010T`)                     -- 2010-02T (result adds precision as necessary)
DATE_ADD(month, 13, `2010T`)                    -- 2011-02T (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_ADD(day, -1, `2017-01-10T`)                -- 2017-01-09T
DATE_ADD(hour, 1, `2017T`)                      -- 2017-01-01T01:00Z
DATE_ADD(hour, 1, `2017-01-02T03:04Z`)          -- 2017-01-02T04:04Z
DATE_ADD(minute, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:05:05.006Z
DATE_ADD(second, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:04:06.006Z

-- Runnable statements
SELECT DATE_ADD(year, 5, `2010-01-01T`) FROM << 0 >> -- 2015-01-01T
SELECT DATE_ADD(day, -1, `2017-01-10T`) FROM << 0 >> -- 2017-01-09T
```

## 相關函數

+ [DATE\$1DIFF](ql-functions.date_diff.md)
+ [EXTRACT](ql-functions.extract.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)
+ [UTCNOW](ql-functions.utcnow.md)