翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# TO\$1DATE 関数
TO\$1DATE は、文字列で表記された日付を DATE データ型に変換します。
## 構文
```
TO_DATE (date_str)
```
```
TO_DATE (date_str, format)
```
## 引数
*date\$1str*
日付文字列または日付文字列にキャストできるデータ型。
*format*
Spark の日時パターンに一致する文字列リテラル。有効な日時パターンについては、[「フォーマットと解析の日時パターン](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html)」を参照してください。
## 戻り型
TO\$1DATE は、*format* の値に応じて DATE を返します。
*フォーマット*への変換が失敗すると、エラーが返されます。
## 例
次の SQL ステートメントは、日付 `02 Oct 2001` を日付データ型に変換します。
```
select to_date('02 Oct 2001', 'dd MMM yyyy');
to_date
------------
2001-10-02
(1 row)
```
次の SQL ステートメントは、文字列 `20010631` を日付に変換します。
```
select to_date('20010631', 'yyyyMMdd');
```
次の SQL ステートメントは、文字列 `20010631` を日付に変換します。
```
to_date('20010631', 'YYYYMMDD', TRUE);
```
6 月には 30 日しかないため、結果は null 値です。
```
to_date
------------
NULL
```