Fungsi DateAdd

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

Sintaks

Dateadd ( interval, angka, tanggal )

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 mewakili literal yang akan ditambahkan interval.

Tips:  Di Access 2010, penyusun ekspresi memiliki IntelliSense, sehingga Anda dapat melihat argumen apa yang diperlukan oleh ekspresi Anda. 

Pengaturan

argumeninterval 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 bisa 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 bisa menggunakan hari dalam setahun ("y"), hari ("d"), atau hari kerja ("w").

Fungsi 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 tanggal 31-Jan-96, akan menghasilkan 29-Feb-96 karena 1996 adalah tahun lompatan.

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

Jika Number bukan nilai panjang, maka angka dibulatkan ke bilangan bulat terdekat sebelum dievaluasi.

Catatan:  Format nilai yang dikembalikan untuk Dateadd ditentukan oleh pengaturan panel kontrol , bukan berdasarkan format yang dilewatkan dalam argumen tanggal .

Catatan:  Untuk tanggal, jika pengaturan properti kalender adalah Gregorian, tanggal yang disediakan harus Gregorian. Jika kalender adalah Hijriah, tanggal yang disediakan harus berupa Hijriah. Jika nilai bulan adalah nama, nama harus sesuai 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

Pilih DateAdd ("YYYY", 1, [DateofSale]) sebagai Ekspr1 dari ProductSales;

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

Pilih DateAdd ("YYYY",-1, [DateofSale]) sebagai Ekspr1 dari ProductSales;

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

Pilih DateAdd ("d", 10, [DateofSale]) sebagai NewDate dari ProductSales;

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

Pilih DateAdd ("WW",-1, [DateofSale]) sebagai NewDate dari ProductSales;

Mengembalikan hasil dalam kolom "NewDate" dengan mengurangkan 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, pilih Referensi Pengembang di daftar turun bawah di samping Cari dan masukkan satu istilah atau lebih di kotak pencarian.

Contoh ini mengambil tanggal sebagai input dan menggunakan fungsi Dateadd untuk menampilkan tanggal terkait dalam jumlah bulan yang ditentukan 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

Catatan:  Halaman ini diterjemahkan menggunakan mesin dan mungkin terdapat kesalahan tata bahasa atau masalah keakuratan. Kami bertujuan menyediakan konten yang bermanfaat untuk Anda. Dapatkah Anda memberi tahu kami apakah informasi ini bermanfaat untuk Anda? Berikut adalah artikel dalam bahasa Inggris untuk referensi.

Kembangkan keterampilan Office Anda
Jelajahi pelatihan
Dapatkan fitur baru terlebih dahulu
Gabung ke Office Insiders

Apakah informasi ini bermanfaat?

Terima kasih atas umpan balik Anda!

Terima kasih atas umpan balik Anda! Sepertinya menghubungkan Anda ke salah satu agen dukungan Office kami akan sangat membantu.

×