Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

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

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

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

**注意**  
TO\$1DATE 不支援帶有 Q 的格式字串 (季編號)。

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

```
TO_DATE(string, format)
```

```
TO_DATE(string, format, is_strict)
```

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

 *string*   
要轉換的字串。

 *format*   
字串常值，定義輸出 *string* 的日期部分格式。如需有效日、月和年格式的清單，請參閱[日期時間格式字串](r_FORMAT_strings.md)。

 *is\$1strict*   
選用的布林值，指定如果輸入日期值超出範圍，是否會傳回錯誤。當 *is\$1strict* 設定為 `TRUE` 時，如果有超出範圍的值，就會傳回錯誤。當 *is\$1strict* 設定為 `FALSE` (預設值) 時，就會接受溢位值。

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

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

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

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

 下列 SQL 陳述式會將日期 `02 Oct 2001` 轉換為日期資料類型。

```
select to_date('02 Oct 2001', 'DD Mon YYYY');

to_date
------------
2001-10-02
(1 row)
```

 下列 SQL 陳述式會將字串 `20010631` 轉換為日期。

```
select to_date('20010631', 'YYYYMMDD', FALSE);
```

結果是 2001 年 7 月 1 日，因為 6 月只有 30 天。

```
to_date
------------
2001-07-01
```

 下列 SQL 陳述式會將字串 `20010631` 轉換為日期：

```
to_date('20010631', 'YYYYMMDD', TRUE);
```

結果是錯誤，因為六月只有 30 天。

```
ERROR:  date/time field date value out of range: 2001-6-31
```