O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função TO\$1DATE
<a name="r_TO_DATE_function"></a>

TO\$1DATE converte uma data representada em uma string de caracteres para um tipo de dados DATE. 

**nota**  
TO\$1DATE não aceita strings de formato com Q (número do trimestre).

## Sintaxe
<a name="r_TO_DATE_function-synopsis"></a>

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

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

## Argumentos
<a name="r_TO_DATE_function-arguments"></a>

 *string*   
Uma string a ser convertida. 

 *formato*   
Um literal de string que define o formato da *string* de entrada, em termos de suas partes de data. Para obter uma lista dos formatos válidos de dia, mês e ano, consulte [Strings de formato datetime](r_FORMAT_strings.md). 

 *is\$1strict*   
Um valor booleano opcional que especifica se um erro é retornado se um valor de data de entrada estiver fora do intervalo. Quando *is\$1strict* é definido como `TRUE`, um erro será retornado se houver um valor fora do intervalo. Quando *is\$1strict* é definido como `FALSE`, que é o padrão, então os valores de estouro são aceitos. 

## Tipo de retorno
<a name="r_TO_DATE_function-return-type"></a>

TO\$1DATE retorna uma DATE, dependendo do valor do *format*. 

Se ocorrer falha na conversão no *formato*, um erro será gerado. 

## Exemplos
<a name="r_TO_DATE_function-example"></a>

 A instrução SQL a seguir converte a data `02 Oct 2001` em um tipo de dados de data.

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

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

 A instrução SQL a seguir converte a string `20010631` em uma data.

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

O resultado é 1 de julho de 2001, porque há apenas 30 dias em junho.

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

 A seguinte instrução SQL converte a string `20010631` em uma data: 

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

O resultado é um erro porque há apenas 30 dias em junho.

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