date_diff fungsi

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

Mengembalikan selisih antara dua tanggal dalam hari, atau antara dua cap waktu dalam satuan tertentu.

Sintaks

date_diff(endDate, startDate)

date_diff(unit, start, end)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

Argumen

  • endDate: Ekspresi akhir DATE .
  • startDate: Ekspresi awal DATE .
  • unit: Satuan ukuran.
  • start: Ekspresi awal TIMESTAMP .
  • end: Ekspresi akhir TIMESTAMP .

Mengembalikan

  • Untuk date_diff(endDate, startDate), an INTEGER yang mewakili jumlah hari dari startDate hingga endDate.
  • Untuk date_diff(unit, start, end), a BIGINT yang mewakili selisih antara start dan end yang diukur dalam units. Bentuk ini adalah sinonim untuk timestampdiff fungsi.

Hasilnya negatif jika nilai awal lebih besar dari nilai akhir.

Fungsi ini menghitung seluruh unit yang telah berlalu berdasarkan UTC dengan DAY merupakan 86400 detik.

Satu bulan dianggap telah berlalu ketika bulan kalender telah bertambah dan hari dan waktu kalender sama atau lebih besar dari awal. Minggu, kuartal, dan tahun mengikuti dari itu.

Contoh

> SELECT date_diff(DATE'2009-07-31', DATE'2009-07-30');
 1

-- One second shy of a month elapsed
> SELECT date_diff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 11:59:59');
 0

-- One month has passed even though its' not end of the month yet because day and time line up.
> SELECT date_diff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 12:00:00');
 1

-- Start is greater than the end
> SELECT date_diff(YEAR, DATE'2021-01-01', DATE'1900-03-28');
 -120