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

# Amazon QLDB 中的 TO\$1TIMESTAMP 函數
<a name="ql-functions.to_timestamp"></a>

**重要**  
支援終止通知：現有客戶將可以使用 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 中，提供代表時間戳記的字串，請使用 `TO_TIMESTAMP`函數將字串轉換為`timestamp`資料類型。這是 的反向操作`TO_STRING`。

## 語法
<a name="ql-functions.to_timestamp.syntax"></a>

```
TO_TIMESTAMP ( string [, 'format' ] )
```

## 引數
<a name="ql-functions.to_timestamp.arguments"></a>

*string*  
函數轉換為時間戳記之資料類型的欄位名稱或表達`string`式。

*format*  
（選用） 字串常值，以日期部分定義輸入*字串*的格式模式。如需有效的格式，請參閱 [時間戳記格式字串](ql-functions.timestamp-format.md)。  
如果省略此引數，函數會假設*字串*的格式為[標準 Ion 時間戳記](http://amzn.github.io/ion-docs/docs/spec.html#timestamp)。這是使用此函數剖析 Ion 時間戳記的建議方法。  
使用單一字元格式符號 （例如 `y`、`M`、`d`、`H``h`、、、`s`) 時，可選用零填補`m`，但其零填補變體 （例如 `yyyy`、`MM`、、`dd``HH``hh`、`mm`、) 需要`ss`。  
特殊處理會給予兩位數的年數 （格式符號 `yy`)。1900 會新增至大於或等於 70 的值，2000 會新增至小於 70 的值。  
月名稱和 AM 或 PM 指標不區分大小寫。

## 傳回類型
<a name="ql-functions.to_timestamp.return-type"></a>

`timestamp`

## 範例
<a name="ql-functions.to_timestamp.examples"></a>

```
TO_TIMESTAMP('2007T')                         -- `2007T`
TO_TIMESTAMP('2007-02-23T12:14:33.079-08:00') -- `2007-02-23T12:14:33.079-08:00`
TO_TIMESTAMP('2016', 'y')                     -- `2016T`
TO_TIMESTAMP('2016', 'yyyy')                  -- `2016T`
TO_TIMESTAMP('02-2016', 'MM-yyyy')            -- `2016-02T`
TO_TIMESTAMP('Feb 2016', 'MMM yyyy')          -- `2016-02T`
TO_TIMESTAMP('February 2016', 'MMMM yyyy')     -- `2016-02T`

-- Runnable statements
SELECT TO_TIMESTAMP('2007T') FROM << 0 >>              -- 2007T
SELECT TO_TIMESTAMP('02-2016', 'MM-yyyy') FROM << 0 >> -- 2016-02T
```

## 相關函數
<a name="ql-functions.to_timestamp.related"></a>
+ [CAST](ql-functions.cast.md)
+ [DATE\$1ADD](ql-functions.date_add.md)
+ [DATE\$1DIFF](ql-functions.date_diff.md)
+ [EXTRACT](ql-functions.extract.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [UTCNOW](ql-functions.utcnow.md)