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

# TO\$1TIMESTAMP 関数
<a name="TO_TIMESTAMP"></a>

TO\$1TIMESTAMP は TIMESTAMP 文字列を TIMESTAMPTZ に返します。

## 構文
<a name="TO_TIMESTAMP-syntax"></a>

```
to_timestamp (timestamp)
```

```
to_timestamp (timestamp, format)
```

## 引数
<a name="TO_TIMESTAMP-arguments"></a>

*timestamp*  
タイムスタンプ文字列、またはタイムスタンプ文字列にキャストできるデータ型。

*format*  
Spark の日時パターンに一致する文字列リテラル。有効な日時パターンについては、[「フォーマットと解析の日時パターン](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html)」を参照してください。

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

TIMESTAMP

## 例
<a name="TO_TIMESTAMP-examples"></a>

次の例は、TO\$1TIMESTAMP 関数を使用して TIMESTAMP 文字列を TIMESTAMP に変換する方法を示しています。

```
select current_timestamp() as timestamp, to_timestamp( current_timestamp(), 'YYYY-MM-DD HH24:MI:SS') as second;

timestamp                  | second
--------------------------   ----------------------
2021-04-05 19:27:53.281812 | 2021-04-05 19:27:53+00
```

日付の TO\$1TIMESTAMP 部分を渡すこともできます。残りの日付部分はデフォルト値に設定されます。時刻は出力に含まれません。

```
SELECT TO_TIMESTAMP('2017','YYYY');

to_timestamp
--------------------------
2017-01-01 00:00:00+00
```

次の SQL ステートメントは、文字列「2011-12-18 24:38:15」を TIMESTAMP に変換します。結果は、時間数が 24 時間を超えているため、翌日になる TIMESTAMP になります。

```
select to_timestamp('2011-12-18 24:38:15', 'YYYY-MM-DD HH24:MI:SS');
         
to_timestamp
----------------------
2011-12-19 00:38:15+00
```