DATETIME_DIFF

Menampilkan jumlah batas bagian antara dua tanggal.

Contoh penggunaan

DATETIME_DIFF(Order Date, Ship Date, DAY)

Sintaks

DATETIME_DIFF( date_expression, date_expression, part )

Parameter

  • date_expression - kolom atau ekspresi Tanggal atau Tanggal & Waktu. Jika date_expression pertama terjadi sebelum date_expression kedua, hasilnya nol atau negatif.
  • part - bagian waktu yang akan ditampilkan. DATETIME_DIFF mendukung bagian berikut:
    • MICROSECOND: tersedia untuk kolom atau ekspresi Tanggal & Waktu.
    • MILLISECOND: tersedia untuk kolom atau ekspresi Tanggal & Waktu.
    • SECOND: tersedia untuk kolom atau ekspresi Tanggal & Waktu.
    • MINUTE: tersedia untuk kolom atau ekspresi Tanggal & Waktu.
    • HOUR: tersedia untuk kolom atau ekspresi Tanggal & Waktu.
    • DAY
    • WEEK: Bagian tanggal ini dimulai pada hari Minggu.
    • ISOWEEK: Menggunakan batas minggu ISO 8601. Minggu ISO dimulai pada hari Senin.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: Menggunakan batas tahun penomoran minggu ISO 8601. Batas tahun ISO adalah hari Senin minggu pertama yang hari Kamisnya termasuk dalam tahun kalender Gregorian yang sesuai.

Jenis data yang ditampilkan

Angka (bilangan bulat)

Contoh

Contoh kedua dan ketiga di bawah menunjukkan hasil DATETIME_DIFF untuk dua nilai tanggal yang memiliki perbedaan 24 jam. DATETIME_DIFF dengan bagian WEEK menampilkan 1 karena DATETIME_DIFF menghitung jumlah batas bagian dalam rentang nilai tanggal ini. Setiap WEEK dimulai pada hari Minggu, sehingga ada satu batas bagian antara hari Sabtu, 14-10-2017 00.00.00 dan hari Minggu, 15-10-2017 00.00.00.

Contoh formula Output
DATETIME_DIFF( DATETIME "2010-07-07 10:20:00", DATETIME "2008-12-25 15:30:00", DAY ) 559
DATETIME_DIFF( DATETIME "2017-10-15 00:00:00", DATETIME "2017-10-14 00:00:00", DAY )

1

DATETIME_DIFF( DATETIME "2017-10-15 00:00:00", DATETIME "2017-10-14 00:00:00", WEEK ) 1

Contoh berikut menunjukkan hasil DATETIME_DIFF untuk dua tanggal pada tahun yang berbeda. DATETIME_DIFF dengan bagian tanggal YEAR menampilkan 3 karena menghitung jumlah batas tahun kalender Gregorian antara dua nilai tanggal. DATETIME_DIFF dengan bagian tanggal ISOYEAR menampilkan 2 karena nilai tanggal kedua termasuk dalam tahun ISO 2015. Kamis pertama pada tahun kalender 2015 adalah 2015-01-01, jadi tahun ISO 2015 dimulai pada hari Senin sebelumnya, yaitu 2014-12-29.

Contoh formula Output
DATETIME_DIFF(DATETIME '2017-12-30 00:00:00', DATETIME '2014-12-30 00:00:00', YEAR) 3
DATETIME_DIFF(DATETIME '2017-12-30 00:00:00', DATETIME '2014-12-30 00:00:00', ISOYEAR)

2

Contoh berikut menunjukkan hasil DATETIME_DIFF untuk dua hari berturut-turut. Tanggal pertama jatuh pada hari Senin dan tanggal kedua jatuh pada hari Minggu. DATETIME_DIFF dengan bagian tanggal ISOWEEK juga menampilkan 1 karena minggu ISO dimulai pada hari Senin.

Contoh formula Output
DATETIME_DIFF(DATE '2017-12-18', DATE '2017-12-17', WEEK) 0
DATETIME_DIFF(DATE '2017-12-18', DATE'2017-12-17', ISOWEEK) 1

Catatan

Fungsi ini tidak tersedia untuk jenis tanggal mode kompatibilitas.