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

# TO\$1DATE 陣列
<a name="TO_DATE_function"></a>

TO\$1DATE 將字元字串所表示的日期轉換為 DATE 資料類型。

## 語法
<a name="TO_DATE_function-synopsis"></a>

```
TO_DATE (date_str)
```

```
TO_DATE (date_str, format)
```

## 引數
<a name="TO_DATE_function-arguments"></a>

 *date\$1str*   
日期字串或可轉換為日期字串的資料類型。

 *format*   
符合 Spark 日期時間模式的字串常值。如需有效的日期時間模式，請參閱[格式化和剖析的日期時間模式](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html)。

## 傳回類型
<a name="TO_DATE_function-return-type"></a>

TO\$1DATE 傳回 DATE，視 *format* 值而定。

如果轉換成 *format* 失敗，則會傳回錯誤。

## 範例
<a name="TO_DATE_function-example"></a>

 下列 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);
```

結果是 null 值，因為六月只有 30 天。

```
to_date
------------
NULL
```