Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

TO\$1DATE mengonversi tanggal yang diwakili oleh string karakter ke tipe data DATE. 

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

```
TO_DATE (date_str)
```

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

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

 *date\$1str*   
Sebuah string tanggal atau tipe data yang dapat dilemparkan ke dalam string tanggal. 

 *format*   
String literal yang cocok dengan pola datetime Spark. Untuk pola datetime yang valid, lihat Pola [Datetime untuk Pemformatan dan Penguraian](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html). 

## Jenis pengembalian
<a name="TO_DATE_function-return-type"></a>

TO\$1DATE mengembalikan DATE, tergantung pada nilai *format*. 

Jika konversi ke *format* gagal, maka kesalahan dikembalikan. 

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

 Pernyataan SQL berikut mengubah tanggal `02 Oct 2001` menjadi tipe data tanggal.

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

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

 Pernyataan SQL berikut mengkonversi string `20010631` ke tanggal.

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

 Pernyataan SQL berikut mengkonversi string `20010631` ke tanggal: 

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

Hasilnya adalah nilai nol karena hanya ada 30 hari di bulan Juni.

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