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
