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

# Amazon QLDB の TO\$1TIMESTAMP 関数
<a name="ql-functions.to_timestamp"></a>

**重要**  
サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了まで Amazon QLDB を使用できます。詳細については、[「Amazon QLDB 台帳を Amazon Aurora PostgreSQL に移行する](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)」を参照してください。

Amazon QLDB では、タイムスタンプを表す文字列が指定された場合、`TO_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*  
(オプション) 入力の *string* の日付部分の書式パターンを定義する文字列リテラル。有効な形式については、「[タイムスタンプのフォーマット文字列](ql-functions.timestamp-format.md)」を参照してください。  
この引数を省略すると、関数は *string* が [標準 Ion タイムスタンプ](http://amzn.github.io/ion-docs/docs/spec.html#timestamp)形式であると見なします。これは、この関数を使用して Ion タイムスタンプを解析するために推奨される方法です。  
ゼロパディングは、単一文字の書式記号 (`y`、`M`、`d`、`H`、`h`、`m`、`s` など) を使用する場合はオプションですが、ゼロパディングのバリエーション (`yyyy`、`MM`、`dd`、`HH`、`hh`、`mm`、`ss` など) には必須です。  
2 桁の年 (書式記号 `yy`) は特別に扱われます。70 以上の値には 1900 が加算され、70 未満の値には 2000 が加算されます。  
月名と 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)