Bagikan melalui

Fungsi DATEADD

  • Artikel

Fungsi DATEADD melakukan perhitungan waktu dan tanggal untuk properti yang cocok yang memiliki jenis tanggal. Gunakan fungsi DATEADD untuk mendapatkan tanggal dan waktu dalam jumlah waktu tertentu sebelum saat ini.

Sintaks

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Argumen

DateTimeUnits

Menentukan unit parameter DateTime : YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, atau SECOND. Nilai ini peka huruf besar/kecil, dan tanda kutip tidak diperlukan di sekitar parameter.

OffsetValue

Menentukan offset waktu, dalam unit yang ditentukan oleh parameter DateTimeUnits . OffsetValue harus berupa bilangan bulat negatif. Nilai positif tidak didukung.

DateTime

Menentukan stempel waktu untuk menghitung offset. Ini tidak boleh menjadi tanggal harfiah. Ini harus berupa GETGMTDATE atau hasil dari fungsi DATEADD lainnya.

Keterangan

Fungsi DATEADD hanya dapat digunakan dalam perbandingan nilai harfiah dan hanya di sisi kanan operator perbandingan.

Fungsi GETGMTDATE mengembalikan tanggal dan waktu saat ini di Greenwich Mean Time (GMT). Ingatlah bahwa nilai ini mungkin tidak sama dengan waktu lokal komputer Anda.

Jangan gunakan operator perbandingan yang sama (=) karena representasi waktu internal dapat menghasilkan kesalahan pembulatan yang mengakibatkan hasil pencocokan yang tidak terduga.

Anda dapat menggunakan beberapa fungsi DATEADD untuk menggabungkan unit offset.

Contoh

Contoh klausa WHERE berikut cocok dengan dokumen yang dimodifikasi dalam lima hari terakhir:

...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())

Contoh klausa WHERE berikut cocok dengan dokumen yang dimodifikasi dalam dua hari dan empat jam terakhir:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

Referensi

Perbandingan Nilai Harfiah

Perbandingan Multinilai (ARRAY)

Konseptual

Predikat Teks Lengkap

Predikat Non-Teks Lengkap