Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función TO\$1DATE
<a name="TO_DATE_function"></a>

TO\$1DATE convierte una fecha que se representa con una cadena de caracteres en un tipo de datos DATE. 

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

```
TO_DATE (date_str)
```

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

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

 *date\$1str*   
Una cadena de fecha o un tipo de datos que se puede convertir en una cadena de fecha. 

 *format*   
Un literal de cadena que coincide con los patrones de fecha y hora de Spark. Para ver patrones de fecha y hora válidos, consulta Patrones de [fecha y hora para formatear y](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html) analizar. 

## Tipo de devolución
<a name="TO_DATE_function-return-type"></a>

TO\$1DATE devuelve un valor DATE, en función del valor de *format*. 

Si la conversión a *formato* produce un error, se devuelve un error. 

## Ejemplos
<a name="TO_DATE_function-example"></a>

 La siguiente instrucción SQL convierte la fecha `02 Oct 2001` a un tipo de datos de fecha.

```
select to_date('02 Oct 2001', 'dd MMM yyyy');

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

 La siguiente instrucción SQL convierte la cadena `20010631` en una fecha.

```
select to_date('20010631', 'yyyyMMdd');
```

 La siguiente instrucción SQL convierte la cadena `20010631` en una fecha: 

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

El resultado es un valor nulo porque solo hay 30 días en junio.

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