Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

TO\$1DATE convertit une date représentée par une chaîne de caractères en un type de données DATE. 

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

```
TO_DATE (date_str)
```

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

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

 *date\$1str*   
Chaîne de date ou type de données pouvant être converti en chaîne de date. 

 *format*   
Chaîne littérale qui correspond aux modèles de date/heure de Spark. Pour les modèles de date/heure valides, voir Modèles de [date/heure pour le formatage et](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html) l'analyse syntaxique. 

## Type de retour
<a name="TO_DATE_function-return-type"></a>

TO\$1DATE renvoie une DATE, selon la valeur de *format*. 

Si la conversion au *format* échoue, une erreur est renvoyée. 

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

 L’instruction SQL suivante convertit la date `02 Oct 2001` en type de données de date.

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

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

 L’instruction SQL suivante convertit la chaîne `20010631` en date.

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

 L’instruction SQL suivante convertit la chaîne `20010631` en date : 

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

Le résultat est une valeur nulle car le mois de juin ne compte que 30 jours.

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