Mengembalikan Varian (Tanggal) yang berisi tanggal dengan interval waktu tertentu yang ditambahkan.
Sintaks
DateAdd(interval, number, date)
Fungsi ini DateAdd memiliki argumen berikut:
| Argumen | Deskripsi |
|---|---|
interval |
Diperlukan. Ekspresi string yang merupakan interval waktu yang ingin Anda tambahkan. |
number |
Diperlukan. Ekspresi numerik, yaitu jumlah interval yang ingin Anda tambahkan. Bisa positif untuk mendapatkan tanggal di masa mendatang atau negatif untuk mendapatkan tanggal di masa lalu. |
date |
Diperlukan. Varian (Tanggal) atau literal yang mewakili tanggal ditambahkan interval. |
Pengaturan
Argumen ini interval memiliki pengaturan berikut:
| 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 ini DateAdd untuk menambahkan atau mengurangi interval waktu yang ditentukan dari tanggal. Misalnya, Anda dapat menggunakannya 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 Tahun ("y"), Hari ("d"), atau Hari Kerja ("w").
Fungsi ini DateAdd tidak akan mengembalikan tanggal yang tidak valid. Contoh berikut menambahkan satu bulan ke 31 Januari:
DateAdd("m", 1, "31-Jan-95")
Dalam kasus ini, DateAdd mengembalikan 28-Feb-95, bukan 31-Feb-95. Jika date adalah 31-Jan-96, itu kembali 29-Feb-96 karena 1996 adalah tahun kabisat.
Jika tanggal yang dihitung akan mendahului tahun 100, yang berarti Anda mengurangi lebih banyak tahun daripada tahun yang ada di date, terjadi kesalahan.
Jika number bukan nilai Panjang, Access membulatkannya ke bilangan bulat terdekat sebelum mengevaluasi ekspresi.
Catatan
Format nilai yang dikembalikan untuk DateAdd ditentukan oleh pengaturan Panel Kontrol, bukan oleh format yang diteruskan dalam date argumen.
Catatan
Untuk date, jika Calendar pengaturan properti adalah Gregorian, tanggal yang diberikan harus Gregorian. Jika kalendernya adalah Hijriah, tanggal yang diberikan haruslah Hijriah. Jika nilai bulan adalah nama, nama harus cocok dengan pengaturan properti saat ini Calendar . Untuk mengurangi kemungkinan konflik, masukkan nilai numerik bulan dalam format Tanggal Pendek.
Contoh kueri
| Ekspresi | Hasil |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Menambahkan 1 tahun ke nilai tanggal di DateofSale bidang. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Mengurangi 1 tahun dari nilai tanggal di DateofSale bidang. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Menambahkan 10 hari ke nilai tanggal di 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 di 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 fungsi untuk DateAdd menampilkan tanggal yang cocok dalam 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