As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

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

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

```
TO_DATE (date_str)
```

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

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

 *data\$1str*   
Uma string de data ou um tipo de dados que pode ser convertido em uma string de data. 

 *format*   
Uma string literal que corresponde aos padrões de data e hora do Spark. Para padrões de data e hora válidos, consulte Padrões de [data e hora para formatação](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html) e análise. 

## Tipo de retorno
<a name="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="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 MMM 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');
```

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

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

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

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