Bagikan melalui


DATEADD (Ekspresi SSIS)

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

Mengembalikan nilai DT_DBTIMESTAMP baru setelah menambahkan angka yang menunjukkan interval tanggal atau waktu ke bagian tanggal yang ditentukan dalam tanggal. Parameter angka harus dievaluasi ke bilangan bulat, dan parameter tanggal harus dievaluasi ke tanggal yang valid.

Sintaks

  
DATEADD(datepart, number, date)  

Argumen

datepart
Adalah parameter yang menentukan bagian mana dari tanggal untuk menambahkan angka.

number
Adalah nilai yang digunakan untuk menaikkan datepart. Nilai harus berupa nilai bilangan bulat yang diketahui saat ekspresi diurai.

date
Adalah ekspresi yang mengembalikan tanggal atau string yang valid dalam format tanggal.

Jenis Hasil

DT_DBTIMESTAMP

Keterangan

Tabel berikut mencantumkan datepart dan singkatan yang dikenali oleh evaluator ekspresi. Nama datepart tidak peka huruf besar/kecil.

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

Argumen angka harus tersedia saat ekspresi diurai. Argumen dapat berupa konstanta atau variabel. Anda tidak dapat menggunakan nilai kolom karena nilai tidak diketahui saat ekspresi diurai.

Argumen datepart harus diapit oleh tanda kutip.

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

DATEADD mengembalikan hasil null jika argumen null.

Kesalahan terjadi jika tanggal tidak valid, jika unit tanggal atau waktu bukan string, atau jika kenaikan bukan bilangan bulat statis.

Contoh Ekspresi SSIS

Contoh ini menambahkan satu bulan ke tanggal saat ini.

DATEADD("Month", 1,GETDATE())  

Contoh ini menambahkan 21 hari ke tanggal di kolom ModifiedDate .

DATEADD("day", 21, ModifiedDate)  

Contoh ini menambahkan 2 tahun ke tanggal harfiah.

DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")  

Lihat Juga

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