Mengembalikan Varian (Tanggal) yang berisi tanggal dengan interval waktu tertentu yang ditambahkan.
Sintaks
DateAdd(interval, number, date)
Fungsi DateAdd ini memiliki argumen ini:
| Argumen | Deskripsi |
|---|---|
interval |
Diperlukan. Ekspresi string yang merupakan interval waktu yang ingin Anda tambahkan. |
number |
Diperlukan. Ekspresi numerik yang merupakan jumlah interval yang ingin Anda tambahkan. Bisa positif untuk mendapatkan tanggal di masa depan atau negatif untuk mendapatkan tanggal di masa lalu. |
date |
Diperlukan. Varian (Tanggal) atau literal yang menunjukkan tanggal ditambahkannya interval. |
Pengaturan
Argumen interval 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 untuk DateAdd 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 date, 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 date 31-Jan-96, mengembalikan 29-Feb-96 karena 1996 adalah tahun kampung.
Jika tanggal terhitung akan mendahului tahun 100, yang berarti Anda mengurangi lebih banyak tahun daripada berada di date, kesalahan terjadi.
Jika number bukan nilai Long, Access membulatkannya ke bilangan bulat terdekat sebelum mengevaluasi ekspresi.
Catatan
Format nilai yang dikembalikan ditentukan DateAdd oleh pengaturan Panel Kontrol, bukan dengan format yang dikirimkan dalam date argumen.
Catatan
Untuk date, jika Calendar pengaturan properti adalah Gregorian, tanggal yang disediakan harus gregorian. Jika kalender adalah Hijriyah, tanggal yang disediakan harus Hijriyah. Jika nilai bulan adalah nama, nama harus cocok dengan pengaturan properti saat ini Calendar . Untuk mengurangi kemungkinan konflik, masukkan nilai bulan numerik dalam format Tanggal Pendek.
Contoh kueri
| Ekspresi | Hasil |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Menambahkan 1 tahun ke nilai tanggal dalam DateofSale bidang. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Mengurangi 1 tahun dari nilai tanggal dalam DateofSale bidang. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Menambahkan 10 hari ke nilai tanggal dalam DateofSale bidang dan mengembalikan hasil dalam NewDate kolom. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Mengurangi 1 minggu, atau 7 hari, dari nilai tanggal dalam DateofSale bidang dan mengembalikan hasil dalam NewDate kolom. |
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 DateAdd fungsi untuk menampilkan tanggal yang cocok dengan 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