datepart syntax 

Parameter datepart mendefinisikan satuan waktu untuk menghitung selisih. SQL Server mendukung nilai datepart berikut:

Catatan: MySQL hanya mendukung day sebagai satuan waktu untuk DATEDIFF().

• Tanda kutip: Selalu gunakan tanda kutip tunggal (') untuk nilai tanggal dan waktu.
• Hasil positif dan negatif: Di SQL Server, hasilnya positif ketika enddate > startdate dan negatif sebaliknya.
• Penanganan error: Jika hasil melebihi ±2.147.483.647, gunakan DATEDIFF_BIG() di SQL Server.

Contoh DATEDIFF()

Saat bekerja dengan DATEDIFF(), hasilnya bisa berupa nilai positif atau negatif. Jika enddate lebih lambat daripada startdate, maka DATEDIFF() mengembalikan nilai positif. Jika enddate lebih awal daripada startdate, DATEDIFF() mengembalikan nilai negatif. 

Contoh 1: Menemukan selisih antara dua tanggal

Di SQL Server:

SELECT DATEDIFF(year, '2022-12-31', '2024-06-01') AS years_difference;
Didukung oleh

Penjelasan: Ini menghitung selisih dalam tahun antara dua tanggal. Karena tahun 2023 dan sebagian 2024 dihitung, hasilnya adalah 1.

Di MySQL: 

SELECT DATEDIFF('2024-06-01', '2022-12-31') AS days_difference;Didukung oleh

Penjelasan: MySQL hanya mendukung selisih dalam satuan hari. Hasilnya adalah 518.

Contoh 2: Menemukan selisih antara dua timestamp

SELECT 
    DATEDIFF(hour, '2023-12-31 00:00:00', '2023-12-31 23:59:59') AS hours_difference,
    DATEDIFF(minute, '2023-12-31 00:00:00', '2023-12-31 23:59:59') AS minutes_difference,
    DATEDIFF(second, '2023-12-31 00:00:00', '2023-12-31 23:59:59') AS seconds_difference;
Didukung oleh

Penjelasan:

• hours_difference menghasilkan 23 karena kedua timestamp berjarak 23 jam.
• minutes_difference menghasilkan 1439, yaitu 23 hours * 60 minutes.
• seconds_difference menghasilkan 86,399, yaitu 1439 minutes * 60 seconds.

Contoh 3: Menemukan selisih antara dua kolom tanggal

Misalkan Anda memiliki tabel orders dengan order_date dan shipped_date. Gunakan DATEDIFF() untuk menghitung waktu pengiriman untuk setiap pesanan.

SELECT 
    order_id,
    DATEDIFF(day, order_date, shipped_date) AS shipping_days 
FROM sales.orders;
Didukung oleh

Penjelasan: Kueri menghitung jumlah hari yang dibutuhkan untuk mengirim setiap pesanan.

Contoh 4. Menemukan interval antara tanggal hari ini dan sebuah kolom

Menggunakan tabel sales.orders seperti pada Contoh 3, kita dapat menggunakan DATEDIFF() untuk menemukan interval antara tanggal hari ini dan tanggal saat pesanan dibuat.

SELECT 
    order_id,
    order_date,
    GETDATE() AS today_date,
    DATEDIFF(day, order_date, GETDATE()) AS days_from_order;
Didukung oleh

Penjelasan:

• GETDATE() mengambil tanggal dan waktu saat ini di SQL Server.
• Selisih hari dari order_date hingga hari ini dihitung.

Catatan Tambahan

Fungsi DATEDIFF() mengembalikan error jika hasilnya di luar jangkauan (yakni nilainya lebih besar dari +2.147.483.647 atau lebih kecil dari -2.147.483.647). Dalam kasus ini, fungsi DATEDIFF_BIG() lebih tepat digunakan. 

Kesalahan Umum dan Pemecahan Masalah

Saat bekerja dengan DATEDIFF(), mudah menemui masalah terkait sintaks, urutan argumen, atau perilaku spesifik database. Di bawah ini adalah kesalahan umum dan cara menanganinya:

1. Tanda Kutip yang Salah

Masalah: Menggunakan tanda kutip pada datepart atau gaya kutip yang tidak konsisten untuk literal tanggal.

Solusi: Selalu biarkan datepart tanpa tanda kutip dan gunakan tanda kutip tunggal untuk tanggal.

-- Incorrect
SELECT DATEDIFF('year', '2023-01-01', '2024-01-01');

-- Correct
SELECT DATEDIFF(year, '2023-01-01', '2024-01-01');Didukung oleh

2. datepart yang tidak didukung di MySQL

Masalah: DATEDIFF() di MySQL hanya mendukung selisih hari.

Solusi: Gunakan TIMESTAMPDIFF() untuk satuan yang lebih rinci seperti tahun atau bulan.

-- Correct (MySQL)
SELECT TIMESTAMPDIFF(YEAR, '2023-01-01', '2024-01-01') AS years_difference; -- Returns 1Didukung oleh

3. Urutan Argumen Berpengaruh

Masalah: Menukar startdate dan enddate dapat menghasilkan nilai negatif yang tidak diharapkan.

Solusi: Pastikan startdate diletakkan terlebih dahulu. Gunakan ABS() jika hanya besaran nilainya yang penting.

-- Incorrect
SELECT DATEDIFF(day, '2023-01-05', '2023-01-01'); -- Returns -4

-- Correct
SELECT DATEDIFF(day, '2023-01-01', '2023-01-05'); -- Returns 4Didukung oleh

4. Format Tanggal Spesifik Lokal

Masalah: Format tanggal yang ambigu (misalnya, MM/DD/YYYY vs. DD/MM/YYYY) dapat menyebabkan error.

Solusi: Gunakan standar ISO 8601 (YYYY-MM-DD) untuk menghindari ambiguitas.

-- Correct
SELECT DATEDIFF(day, '2023-01-01', '2023-12-31'); -- Returns 364Didukung oleh

5. Nilai di Luar Jangkauan (SQL Server)

Masalah: Selisih yang sangat besar melebihi ±2.147.483.647 menyebabkan error overflow.Solusi: Gunakan DATEDIFF_BIG() untuk rentang yang besar.

-- Correct
SELECT DATEDIFF_BIG(day, '0001-01-01', '9999-12-31'); -- Returns 2,920,862,800Didukung oleh

Persyaratan teknis

Berjalan di SQL Server (mulai 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

Lihat juga

• Fungsi SQL COALESCE()
• Fungsi SQL FORMAT()
• Fungsi SQL INSERT INTO
• Fungsi SQL COUNT()

Pelajari lebih lanjut tentang SQL

• Pusat belajar SQL
• Tutorial SQL
• Cheat Sheet SQL