DATEDIFF (Ekspresi SSIS)

Berlaku untuk: SQL Server SSIS Integration Runtime di Azure Data Factory

Mengembalikan jumlah tanggal dan batas waktu yang dilintasi antara dua tanggal yang ditentukan. Parameter datepart mengidentifikasi batas tanggal dan waktu mana yang akan dibandingkan.

Sintaks

  
DATEDIFF(datepart, startdate, endate)  

Argumen

datepart
Adalah parameter yang menentukan bagian tanggal mana yang akan dibandingkan dan mengembalikan nilai.

startdate
Adalah tanggal mulai interval.

akhiri
Adalah tanggal akhir interval.

Jenis Hasil

DT_I4

Keterangan

Tabel berikut mencantumkan datepart dan singkatan yang dikenali oleh evaluator ekspresi.

Bagian Tanggal	Singkatan
Tahun	yy, yyyy
Kuartal	qq, q
Month	mm, m
Dayofyear	dy, y
Hari	dd, d
Minggu	wk, ww
Weekday	dw, w
Jam	Hh
Menit	mi, n
Detik	ss, s
Milidetik	Ms

DATEDIFF mengembalikan hasil null jika ada argumen null.

Tanggal harfiah harus secara eksplisit dilemparkan ke salah satu jenis data tanggal. Untuk informasi selengkapnya, lihat Jenis Data Integration Services.

Kesalahan terjadi jika tanggal tidak valid, jika unit tanggal atau waktu bukan string, jika tanggal mulai bukan tanggal, atau jika tanggal akhir bukan tanggal.

Jika tanggal akhir lebih awal dari tanggal mulai, fungsi mengembalikan angka negatif. Jika tanggal mulai dan berakhir sama atau jatuh dalam interval yang sama, fungsi mengembalikan nol.

Contoh Ekspresi SSIS

Contoh ini menghitung jumlah hari antara dua literal tanggal. Jika tanggal dalam format "mm/dd/yyyy", fungsi mengembalikan 7.

DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")  

Contoh ini mengembalikan jumlah bulan antara tanggal harfiah dan tanggal saat ini.

DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())  

Contoh ini mengembalikan jumlah minggu antara tanggal di kolom ModifiedDate dan variabel YearEndDate . Jika YearEndDate memiliki jenis data tanggal , tidak diperlukan transmisi eksplisit.

DATEDIFF("Week", ModifiedDate,@YearEndDate)  

Lihat Juga

DATEADD (Ekspresi SSIS)
DATEPART (Ekspresi SSIS)
DAY (Ekspresi SSIS)
MONTH (Ekspresi SSIS)
YEAR (Ekspresi SSIS)
Fungsi (Ekspresi SSIS)