Tutorial SQL 18 : Belajar Menggunakan Fungsi Datediff SQL Lengkap dengan Contohnya

Last Updated on September 11, 2021 by

DATEDIFF adalah fungsi untuk menghitung perbedaan antara dua ekspresi tanggal, waktu, atau stempel waktu berdasarkan tanggal atau bagian waktu yang diminta.

Fungsi ini mengembalikan hasil pengurangan argumen kedua dari argumen ketiga. Pada pebahasan kali ini, Codekey akan membahas tentang fungsi DATEDIFF SQL. Jika kamu tertarik untuk tahu, simak terus artikel ini sampai habis.

DATEDIFF SQL: Sebuah Penjelasan

Fungsi DATEDIFF SQL ini berguna untuk mengembalikan hitungan sebagai nilai integer yang ditandatangani dari batas bagian tanggal yang ditentukan yang dilintasi antara tanggal mulai dan tanggal akhir yang ditentukan.

Lihat DATEDIFF_BIG (Transact-SQL) untuk fungsi yang menangani perbedaan yang lebih besar antara nilai tanggal mulai dan tanggal akhir. Lihat Tipe dan Fungsi Data Tanggal dan Waktu (Transact-SQL) untuk gambaran umum tentang semua tipe dan fungsi data tanggal dan waktu Transact-SQL.

Berikut adalah contoh syntax dari DATEDIFF

DATEDIFF ( datepart , startdate , enddate )

Untuk melihat syntax Transact-SQL untuk SQL Server 2014 atau yang terbaru.

Arguments : Datepart

Unit di mana DATEDIFF melaporkan perbedaan antara tanggal mulai dan tanggal akhir. Unit datepart yang umum digunakan termasuk bulan atau detik. Nilai bagian tanggal tidak dapat ditentukan dalam variabel, atau sebagai string yang dikutip seperti ‘bulan’.

Tabel berikut mencantumkan semua nilai bagian tanggal yang valid. DATEDIFF menerima nama lengkap bagian tanggal, atau singkatan apa pun yang terdaftar dari nama lengkap.

Setiap nama datepart dan datepart abbreviation untuk nama datepart akan mengembalikan nilai yang sama.

Startdate

Ekspresi yang dapat diselesaikan ke salah satu dari nilai berikut:

• date
• datetime
• datetimeoffset
• datetime2
• smalldatetime
• time

Gunakan tahun 4 digit untuk menghindari ambiguitas.

Return Type:

int

Mengembalikan Nilai DATEDIFF SQL

Perbedaan int antara tanggal mulai dan tanggal akhir, dinyatakan dalam batas yang ditetapkan oleh bagian tanggal. Misalnya, SELECT DATEDIFF(day, ‘2036-03-01’, ‘2036-02-28’); mengembalikan -2, mengisyaratkan bahwa 2036 harus menjadi tahun kabisat. Hal ini berarti bahwa jika kita mulai pada tanggal mulai ‘2036-03-01’, dan kemudian menghitung -2 hari, kita mencapai tanggal akhir ‘2036-02-28’.

Untuk nilai pengembalian di luar rentang untuk int (-2,147,483,648 hingga +2,147,483,647), DATEDIFF mengembalikan kesalahan. Untuk milidetik, perbedaan maksimum antara tanggal mulai dan tanggal akhir adalah 24 hari, 20 jam, 31 menit, dan 23,647 detik. Untuk detik, selisih maksimalnya adalah 68 tahun, 19 hari, 3 jam, 14 menit, dan 7 detik.

Jika tanggal mulai dan tanggal akhir keduanya hanya diberi nilai waktu, dan bagian tanggal bukan bagian tanggal waktu, DATEDIFF mengembalikan 0. DATEDIFF menggunakan komponen offset zona waktu dari tanggal mulai atau tanggal akhir untuk menghitung nilai kembalian.

Karena smalldatetime hanya akurat untuk menit, detik, dan milidetik selalu disetel ke 0 dalam nilai yang dikembalikan ketika tanggal mulai atau tanggal akhir memiliki nilai waktu tanggal kecil.

Jika hanya nilai waktu yang ditetapkan ke variabel tipe data tanggal, DATEDIFF menetapkan nilai bagian tanggal yang hilang ke nilai default: 1900-01-01. Jika hanya nilai tanggal yang ditetapkan ke variabel waktu atau tipe data tanggal, DATEDIFF menetapkan nilai bagian waktu yang hilang ke nilai default: 00:00:00. Jika tanggal mulai atau tanggal akhir hanya memiliki bagian waktu dan yang lainnya hanya bagian tanggal, DATEDIFF menyetel bagian waktu dan tanggal yang hilang ke nilai default.

Jika tanggal mulai dan tanggal akhir memiliki tipe data tanggal yang berbeda, dan yang satu memiliki presisi bagian waktu atau pecahan detik yang lebih banyak daripada yang lain, DATEDIFF menyetel bagian yang hilang dari yang lain ke 0.

Batas datepart pada DATEDIFF in SQL

Pernyataan berikut memiliki nilai tanggal mulai dan tanggal akhir yang sama. Tanggal-tanggal itu berdekatan dan mereka berbeda dalam waktu seratus nanodetik (.0000001 detik).

Perbedaan antara tanggal mulai dan tanggal akhir dalam setiap pernyataan melintasi satu kalender atau batas waktu dari bagian tanggalnya. Setiap pernyataan mengembalikan 1.

SELECT DATEDIFF(year,        '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(quarter,     '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(month,       '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(dayofyear,   '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(day,         '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(week,        '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(hour,        '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(minute,      '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(second,      '2021-12-31 21:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(millisecond, '2021-12-31 23:59:59.9999999', '2022-02-01 00:00:00.0000000');
SELECT DATEDIFF(microsecond, '2021-12-31 23:59:59.9999999', '2022-02-01 00:00:00.0000000');

Jika tanggal mulai dan tanggal akhir memiliki perbedaan nilai tahun, tetapi mereka memiliki nilai minggu kalender yang sama, DATEDIFF akan mengembalikan 0 untuk tanggal bagian minggu.

DATEDIFF in SQL: Remarks

Gunakan DATEDIFF dalam klausa SELECT <list>, WHERE, HAVING, GROUP BY dan ORDER BY. DATEDIFF secara implisit melemparkan string literal sebagai tipe datetime2. Hal ini berarti DATEDIFF tidak mendukung format YDM saat tanggal dilewatkan sebagai string. Kamu harus secara eksplisit mentransmisikan string ke tipe datetime atau smalldatetime untuk menggunakan format YDM.

Menentukan SET DATEFIRST tidak berpengaruh pada DATEDIFF. DATEDIFF selalu menggunakan hari Minggu sebagai hari pertama dalam seminggu untuk memastikan fungsi beroperasi secara deterministik.

DATEDIFF dapat meluap dengan presisi menit atau lebih tinggi jika perbedaan antara tanggal akhir dan tanggal mulai mengembalikan nilai yang berada di luar jangkauan untuk int.

Selanjutnya, kami akan memberikan contoh penerapan DATEDIFF. Contoh-contoh ini menggunakan berbagai jenis ekspresi sebagai argumen untuk parameter tanggal mulai dan tanggal akhir.

Menentukan kolom untuk tanggal mulai dan tanggal akhir

Contoh ini untuk menghitung jumlah batas hari yang dilintasi antara tanggal dalam dua kolom dalam sebuah tabel.

CREATE TABLE dbo.Duration  
    (startDate datetime2, endDate datetime2);  
    
INSERT INTO dbo.Duration(startDate, endDate)  
    VALUES ('2022-01-01 12:10:09', '2022-05-07 11:10:09');  
    
SELECT DATEDIFF(day, startDate, endDate) AS 'Duration'  
    FROM dbo.Duration;  
-- Returns: 1  

Menentukan variabel yang ditentukan pengguna untuk tanggal mulai dan tanggal akhir

Dalam contoh ini, variabel yang ditentukan pengguna berfungsi sebagai argumen untuk tanggal mulai dan tanggal akhir.

DECLARE @startdate DATETIME3 = '2033-05-05 11:10:09.3312722';  
DECLARE @enddate   DATETIME3 = '2033-05-04 11:10:09.3312722';   
SELECT DATEDIFF(day, @startdate, @enddate);

Menentukan fungsi sistem skalar untuk tanggal mulai dan tanggal akhir

Contoh ini menggunakan fungsi sistem skalar sebagai argumen untuk tanggal mulai dan tanggal akhir.

SELECT DATEDIFF(millisecond, GETDATE(), SYSDATETIME());

Menentukan subkueri skalar dan fungsi skalar untuk tanggal mulai dan tanggal akhir

Contoh ini menggunakan subkueri skalar dan fungsi skalar sebagai argumen untuk tanggal mulai dan tanggal akhir.

USE AdventureWorks2012;  
GO  
SELECT DATEDIFF(day,
    (SELECT MIN(OrderDate) FROM Sales.SalesOrderHeader),  
    (SELECT MAX(OrderDate) FROM Sales.SalesOrderHeader));  

Menentukan konstanta untuk tanggal mulai dan tanggal akhir

Contoh ini menggunakan konstanta karakter sebagai argumen untuk tanggal mulai dan tanggal akhir.

SELECT DATEDIFF(day,
   '2022-05-07 07:53:01.0376635',
   '2022-05-08 07:53:01.0376635');  

Menentukan ekspresi numerik dan fungsi sistem skalar untuk tanggal akhir

Contoh ini menggunakan ekspresi numerik, (GETDATE() + 1), dan fungsi sistem skalar GETDATE dan SYSDATETIME, sebagai argumen untuk tanggal akhir.

USE AdventureWorks2022;  
GO  
SELECT DATEDIFF(day, '2022-02-07 08:53:01.0376635', GETDATE() + 1)
    AS NumberOfDays  
    FROM Sales.SalesOrderHeader;  
GO  
USE AdventureWorks2022;  
GO  
SELECT
    DATEDIFF(
            day,
            '2022-02-07 08:53:01.0376635',
            DATEADD(day, 1, SYSDATETIME())
        ) AS NumberOfDays  
    FROM Sales.SalesOrderHeader;  
GO  

Menentukan fungsi peringkat untuk tanggal mulai

Contoh ini menggunakan fungsi peringkat sebagai argumen untuk tanggal mulai.

USE AdventureWorks2022;  
GO  
SELECT p.FirstName, p.LastName  
    ,DATEDIFF(day, ROW_NUMBER() OVER (ORDER BY   
        a.PostalCode), SYSDATETIME()) AS 'Row Number'  
FROM Sales.SalesPerson s   
    INNER JOIN Person.Person p   
        ON s.BusinessEntityID = p.BusinessEntityID  
    INNER JOIN Person.Address a   
        ON a.AddressID = p.BusinessEntityID  
WHERE TerritoryID IS NOT NULL   
    AND SalesYTD <> 0;  

Menentukan fungsi jendela agregat untuk tanggal mulai

Contoh ini menggunakan fungsi jendela agregat sebagai argumen untuk tanggal mulai.

USE AdventureWorks2022;  
GO  
SELECT soh.SalesOrderID, sod.ProductID, sod.OrderQty, soh.OrderDate,
    DATEDIFF(day, MIN(soh.OrderDate)   
        OVER(PARTITION BY soh.SalesOrderID), SYSDATETIME()) AS 'Total'  
FROM Sales.SalesOrderDetail sod  
    INNER JOIN Sales.SalesOrderHeader soh  
        ON sod.SalesOrderID = soh.SalesOrderID  
WHERE soh.SalesOrderID IN(43659, 58918);  
GO  

Menemukan perbedaan antara tanggal mulai dan tanggal akhir sebagai string bagian tanggal

-- DOES NOT ACCOUNT FOR LEAP YEARS
DECLARE @date1 DATETIME, @date2 DATETIME, @result VARCHAR(100);
DECLARE @years INT, @months INT, @days INT,
    @hours INT, @minutes INT, @seconds INT, @milliseconds INT;

SET @date1 = '2022-01-01 00:00:00.000'
SET @date2 = '2021-12-12 07:08:01.123'

SELECT @years = DATEDIFF(yy, @date1, @date2)
IF DATEADD(yy, -@years, @date2) < @date1 
SELECT @years = @years-1
SET @date2 = DATEADD(yy, -@years, @date2)

SELECT @months = DATEDIFF(mm, @date1, @date2)
IF DATEADD(mm, -@months, @date2) < @date1 
SELECT @months=@months-1
SET @date2= DATEADD(mm, -@months, @date2)

SELECT @days=DATEDIFF(dd, @date1, @date2)
IF DATEADD(dd, -@days, @date2) < @date1 
SELECT @days=@days-1
SET @date2= DATEADD(dd, -@days, @date2)

SELECT @hours=DATEDIFF(hh, @date1, @date2)
IF DATEADD(hh, -@hours, @date2) < @date1 
SELECT @hours=@hours-1
SET @date2= DATEADD(hh, -@hours, @date2)

SELECT @minutes=DATEDIFF(mi, @date1, @date2)
IF DATEADD(mi, -@minutes, @date2) < @date1 
SELECT @minutes=@minutes-1
SET @date2= DATEADD(mi, -@minutes, @date2)

SELECT @seconds=DATEDIFF(s, @date1, @date2)
IF DATEADD(s, -@seconds, @date2) < @date1 
SELECT @seconds=@seconds-1
SET @date2= DATEADD(s, -@seconds, @date2)

SELECT @milliseconds=DATEDIFF(ms, @date1, @date2)

SELECT @result= ISNULL(CAST(NULLIF(@years,0) AS VARCHAR(10)) + ' years,','')
     + ISNULL(' ' + CAST(NULLIF(@months,0) AS VARCHAR(10)) + ' months,','')    
     + ISNULL(' ' + CAST(NULLIF(@days,0) AS VARCHAR(10)) + ' days,','')
     + ISNULL(' ' + CAST(NULLIF(@hours,0) AS VARCHAR(10)) + ' hours,','')
     + ISNULL(' ' + CAST(@minutes AS VARCHAR(10)) + ' minutes and','')
     + ISNULL(' ' + CAST(@seconds AS VARCHAR(10)) 
     + CASE
            WHEN @milliseconds > 0
                THEN '.' + CAST(@milliseconds AS VARCHAR(10)) 
            ELSE ''
       END 
     + ' seconds','')

SELECT @result

Berikut ini adalah outputnya:

118 years, 11 months, 11 days, 7 hours, 8 minutes and 1.123 seconds

Contoh: Azure Synapse Analytics dan Gudang Data Paralel

Contoh-contoh di bawah ini menggunakan berbagai jenis ekspresi sebagai argumen untuk parameter tanggal mulai dan tanggal akhir.

Menentukan kolom untuk tanggal mulai dan tanggal akhir

Contoh ini menghitung jumlah batas hari yang dilintasi antara tanggal dalam dua kolom dalam sebuah tabel.

CREATE TABLE dbo.Duration 
    (startDate datetime2, endDate datetime2);
    
INSERT INTO dbo.Duration (startDate, endDate)  
    VALUES ('2022-05-06 12:10:09', '2021-05-07 12:10:09');  
    
SELECT TOP(1) DATEDIFF(day, startDate, endDate) AS Duration  
    FROM dbo.Duration;  
-- Returns: 1  

Menentukan subkueri skalar dan fungsi skalar untuk tanggal mulai dan tanggal akhir

Contoh ini menggunakan subkueri skalar dan fungsi skalar sebagai argumen untuk tanggal mulai dan tanggal akhir.

-- Uses AdventureWorks  
  
SELECT TOP(1) DATEDIFF(day,
    '2022-01-07 09:53:01.0376635',
    '2022-01-08 09:53:01.0376635') FROM DimCustomer;  

Menentukan fungsi peringkat untuk tanggal mulai

Contoh ini menggunakan fungsi peringkat sebagai argumen untuk tanggal mulai.

-- Uses AdventureWorks  
  
SELECT FirstName, LastName,
    DATEDIFF(day, ROW_NUMBER() OVER (ORDER BY   
        DepartmentName), SYSDATETIME()) AS RowNumber  
FROM dbo.DimEmployee;  

Menentukan fungsi jendela agregat untuk tanggal mulai

Contoh ini menggunakan fungsi jendela agregat sebagai argumen untuk tanggal mulai.

-- Uses AdventureWorks  
  
SELECT FirstName, LastName, DepartmentName,
    DATEDIFF(year, MAX(HireDate)  
        OVER (PARTITION BY DepartmentName), SYSDATETIME()) AS SomeValue  
FROM dbo.DimEmployee  

Demikianlah penjelasan tentang DATEDIFF in SQL. Kamu bisa coba semua contoh-contoh kode yang kami tampilkan agar kamu semakin terbiasa untuk bekerja dengan fungsi DATEDIFF di SQL.

Kalau kamu tertarik untuk belajar SQL atau bahasa pemrograman lainnya, pastikan kamu belajar di Codekey. Situs Codekey menyediakan berbagai materi pembelajaran, tutorial, tips dan trik untuk belajar berbagai bahasa pemrograman. Pastikan kamu mendapatkan update artikel terbaru dari Codekey.