Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

TO\$1DATE konvertiert ein Datum in einer Zeichenfolge in den Datentyp DATE. 

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

```
TO_DATE (date_str)
```

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

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

 *date\$1str*   
Eine Datumszeichenfolge oder ein Datentyp, der in eine Datumszeichenfolge umgewandelt werden kann. 

 *format*   
Ein Zeichenkettenliteral, das den Datetime-Mustern von Spark entspricht. Gültige Datetime-Muster finden Sie unter [Datetime-Muster für](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html) Formatierung und Analyse. 

## Rückgabetyp
<a name="TO_DATE_function-return-type"></a>

TO\$1DATE gibt ein DATE zurück, abhängig vom *Formatwert*. 

Wenn die Konvertierung in das *Format* fehlschlägt, wird ein Fehler zurückgegeben. 

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

 Die folgende SQL-Anweisung konvertiert das Datum `02 Oct 2001` in einem Datumsdatentyp.

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

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

 Die folgende SQL-Anweisung konvertiert die Zeichenfolge `20010631` in ein Datum.

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

 Die folgende SQL-Anweisung konvertiert die Zeichenfolge `20010631` in ein Datum: 

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

Das Ergebnis ist ein Nullwert, da der Juni nur 30 Tage hat.

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