Mengembalikan Varian (Tanggal) yang berisi tanggal yang telah ditambahkan interval waktu yang ditentukan.

Sintaks

DateAdd ( interval, number, date )

Sintaks fungsi DateAdd memiliki argumen ini:

Argumen

Deskripsi

interval

Diperlukan. Ekspresi string yang merupakan interval waktu yang ingin Anda tambahkan.

angka

Diperlukan. Ekspresi numerik yang merupakan jumlah interval yang ingin Anda tambahkan. Dapat berupa positif (untuk mendapatkan tanggal di masa mendatang) atau negatif (untuk mendapatkan tanggal di masa lalu).

tanggal

Diperlukan. Varian (Tanggal) atau tanggal yang mewakili tanggal penambahan interval.

Pengaturan

Interval argumen memiliki pengaturan ini:

Pengaturan

Deskripsi

yyyy

Tahun

q

Kuartal

m

Bulan

y

Hari dalam setahun

d

Hari

w

Hari kerja

ww

Minggu

h

Jam

n

Menit

s

Detik

Keterangan

Anda dapat menggunakan fungsi DateAdd untuk menambahkan atau mengurangi interval waktu tertentu dari tanggal. Misalnya, Anda bisa menggunakan DateAdd untuk menghitung tanggal 30 hari dari hari ini atau waktu 45 menit dari sekarang.

Untuk menambahkan hari ke tanggal, Anda dapat menggunakan Hari Dalam Setahun ("y"), Hari ("d"), atau Hari Kerja ("w").

Fungsi DateAdd tidak akan mengembalikan tanggal yang tidak valid. Contoh berikut ini menambahkan satu bulan ke 31 Januari:

DateAdd("m", 1, "31-Jan-95")

Dalam hal ini, DateAdd mengembalikan 28-Feb-95, bukan 31-Feb-95. Jika tanggal adalah 31-Jan-96, maka mengembalikan 29-Feb-96 karena 1996 adalah tahun kampung.

Jika tanggal terhitung akan mendahului tahun 100 (yaitu, Anda mengurangi lebih dari tahun dalam tanggal), kesalahan terjadi.

Jika angka bukan nilai Long, angka dibulatkan ke bilangan bulat terdekat sebelum dievaluasi.

Catatan: Format nilai yang dikembalikan untuk DateAdd ditentukan oleh pengaturan Panel Kontrol , bukan dengan format yang dikirimkan dalam argumen tanggal .

Catatan: Untuk tanggal, jika pengaturan properti Kalender adalah Gregorian, tanggal yang disediakan harus gregorian. Jika kalender adalah Hijriyah, tanggal yang disediakan harus Hijriyah. Jika nilai bulan adalah nama, nama harus konsisten dengan pengaturan properti Kalender saat ini. Untuk meminimalkan kemungkinan nama bulan yang berkonflik dengan pengaturan properti Kalender saat ini, masukkan nilai bulan numerik (format Tanggal Pendek).

Contoh kueri

Ekspresi

Hasil

SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales;

Mengembalikan hasil dengan menambahkan 1 tahun ke nilai tanggal bidang "DateofSale".

SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales;

Mengembalikan hasil dengan mengurangi 1 tahun ke nilai tanggal bidang "DateofSale".

SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales;

Mengembalikan hasil dalam kolom "NewDate" dengan menambahkan 10 hari ke nilai tanggal bidang "DateofSale".

SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales;

Mengembalikan hasil dalam kolom "TanggalData Baru" dengan mengurangi 1 minggu (7 hari) dari nilai tanggal bidang "DateofSale".

Contoh VBA

Catatan: Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA). Untuk informasi selengkapnya tentang bekerja dengan VBA, lihat Referensi VBA Access.

Contoh ini mengambil tanggal sebagai input dan menggunakan fungsi DateAdd untuk menampilkan tanggal terkait jumlah bulan tertentu di masa mendatang.

Dim FirstDate As Date    ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m"    ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
    DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg

Lihat Juga

Memilih fungsi tanggal yang benar

Perlu bantuan lainnya?

Ingin opsi lainnya?

Jelajahi manfaat langganan, telusuri kursus pelatihan, pelajari cara mengamankan perangkat Anda, dan banyak lagi.

Komunitas membantu Anda bertanya dan menjawab pertanyaan, memberikan umpan balik, dan mendengar dari para ahli yang memiliki pengetahuan yang luas.