try_add fungsi

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 10.4 LTS ke atas

Menampilkan jumlah expr1 dan expr2, atau NULL jika terjadi kesalahan.

Sintaks

try_add ( expr1 , expr2 )

Fungsi ini juga dapat dipanggil sebagai fungsi jendela menggunakan OVER klausa.

Argumen

  • expr1: Ekspresi numerik, TANGGAL, CAP WAKTU, atau INTERVAL.
  • expr2: Jika expr1 numerik, maka expr2 harus berupa ekspresi numerik, atau jika tidak, berupa INTERVAL.

Pengembalian

  • Jika expr1 bertipe numerik, tipe maksimum umum dari argumen.
  • Jika expr1 TANGGAL dan expr2 merupakan interval hari-jam hasilnya adalah STEMPEL WAKTU.
  • Jika expr1 dan expr2 adalah interval tahun-bulan, maka hasilnya adalah interval tahun-bulan dengan cakupan yang cukup luas untuk mewakili hasilnya.
  • Jika expr1 dan expr2 adalah interval waktu siang, hasilnya adalah interval waktu siang dengan unit yang cukup luas untuk mewakili hasilnya.
  • Jika tidak, jenis hasil sesuai dengan expr1.

Jika kedua ekspresi adalah interval mereka harus dari kelas yang sama.

Jika hasilnya meluap, jenis hasil Databricks SQL akan mengembalikan NULL.

Saat Anda menambahkan interval tahun-bulan ke DATE, Databricks SQL akan memastikan bahwa tanggal yang dihasilkan memiliki bentuk yang benar.

Contoh

> SELECT try_add(1, 2);
 3

> SELECT try_add(DATE'2021-03-20', INTERVAL '2' MONTH);
 2021-5-20

> SELECT try_add(TIMESTAMP'2021-03-20 12:15:29', INTERVAL '3' SECOND);
 2021-03-20 12:15:32

> SELECT typeof(try_add(INTERVAL '3' DAY, INTERVAL '2' HOUR));
 interval day to hour

> SELECT try_add(DATE'2021-03-31', INTERVAL '1' MONTH);
 2021-04-30

> SELECT try_add(127Y, 1Y);
 NULL