Mengembalikan Varian (Long) yang menentukan jumlah interval waktu di antara dua tanggal yang ditentukan.
Sintaks
DateDiff ( interval, tanggal1, tanggal2 [, firstdayofweek] [, firstweekofyear] )
Sintaks fungsi DateDiff memiliki argumen ini:
Tips: Di Access 2010, penyusun ekspresi memiliki IntelliSense, sehingga Anda dapat melihat argumen apa yang diperlukan oleh ekspresi Anda.
|
Argumen |
Deskripsi |
|
interval |
Diperlukan. Ekspresi string yang merupakan interval waktu yang Anda gunakan untuk menghitung selisih antara tanggal1 dan tanggal2. |
|
tanggal1, tanggal2 |
Diperlukan. Varian (tanggal). Dua tanggal yang ingin Anda gunakan dalam penghitungan. |
|
firstdayofweek |
Optional. konstanta yang menentukan hari pertama dalam seminggu. Jika tidak ditentukan, Minggu dianggap sebagai hari pertama dalam seminggu. |
|
firstdayofyear |
Optional. Konstanta yang menentukan minggu pertama dalam setahun. Jika tidak ditentukan, minggu pertama diasumsikan sebagai minggu munculnya tanggal 1 Januari. |
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 |
Argumen firstdayofweek memiliki pengaturan ini:
|
Konstanta |
Nilai |
Deskripsi |
|
vbUseSystem |
0 |
Gunakan pengaturan API NLS. |
|
Vbminggu |
1 |
Minggu (default) |
|
vbMonday |
2 |
Senin |
|
vbTuesday |
3 |
Selasa |
|
Vbrabu |
4 |
Rabu |
|
Vbkamis |
5 |
Kamis |
|
vbFriday |
6 |
Jumat |
|
Vbsabtu |
7 |
Sabtu |
|
Konstanta |
Nilai |
Deskripsi |
|
vbUseSystem |
0 |
Gunakan pengaturan API NLS. |
|
vbFirstJan1 |
1 |
Mulai dengan minggu di mana January 1 terjadi (default). |
|
vbFirstFourDays |
2 |
Mulai dengan minggu pertama yang setidaknya memiliki empat hari dalam tahun baru. |
|
vbFirstFullWeek |
3 |
Mulai dengan minggu pertama dalam setahun. |
Keterangan
Anda bisa menggunakan fungsi DateDiff untuk menentukan berapa interval waktu yang ditentukan ada di antara dua tanggal. Misalnya, Anda mungkin menggunakan DateDiff untuk menghitung jumlah hari di antara dua tanggal, atau jumlah minggu antara hari ini dan akhir tahun.
Untuk menghitung jumlah hari antara tanggal1 dan tanggal2, Anda bisa menggunakan salah satu hari dalam setahun ("y") atau Day ("d"). Ketika interval adalah hari kerja ("w"), DateDiff mengembalikan jumlah minggu di antara dua tanggal tersebut. Jika tanggal1 jatuh pada hari Senin, DateDiff menghitung jumlah hari Senin sampai tanggal2. Ini menghitung tanggal2 tapi tidak tanggal1. Jika interval adalah minggu ("WW"), maka fungsi DateDiff mengembalikan jumlah minggu kalender di antara dua tanggal tersebut. Ini menghitung jumlah hari Minggu antara tanggal1 dan tanggal2. DateDiff menghitung tanggal2 jika jatuh pada hari Minggu; tapi tidak menghitung tanggal1, bahkan jika hal itu jatuh pada hari Minggu.
Jika tanggal1 merujuk ke titik yang lebih baru dalam waktu daripada Tanggal2, fungsi DateDiff mengembalikan angka negatif.
Argumen firstdayofweek mempengaruhi penghitungan yang menggunakan simbol interval "w" dan "WW".
Jika tanggal1 atau tanggal2 adalah terbaca sebagai tanggal, tahun yang ditentukan menjadi bagian permanen dari tanggal tersebut. Namun, jika tanggal1 atau tanggal2 diapit tanda kutip ganda (""), dan Anda menghilangkan tahun, tahun saat ini disisipkan dalam kode Anda setiap kali ekspresi tanggal1 atau tanggal2 dievaluasi. Hal ini memungkinkan untuk menulis kode yang dapat digunakan dalam tahun yang berbeda.
Ketika membandingkan 31 Desember dengan 1 Januari tahun berikutnya, DateDiff untuk tahun ("yyyy") mengembalikan 1, meskipun hanya satu hari yang telah berlalu.
Catatan: Untuk tanggal1 dan tanggal2, jika pengaturan properti kalender adalah Gregorian, tanggal yang disediakan harus Gregorian. Jika kalender adalah Hijriah, tanggal yang disediakan harus berupa Hijriah.
Contoh kueri DateDiff
|
Ekspresi |
Hasil |
|
Pilih DateDiff ("yyyy", #01/01/2010 #, [DateofSale]) sebagai Ekspr1 dari ProductSales; |
Mengembalikan selisih antara Tanggal2 dan Tanggal1 (mempertimbangkan Tanggal1 sebagai terlama dan Tanggal2 sebagai terbaru) sebagai jumlah ' tahun '. Hasil: Selisih antara nilai dalam bidang "DateofSale" dan tanggal "01/01/2010" sebagai jumlah ' tahun '. |
|
Pilih DateDiff ("q", [DateofSale], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateofSale" sebagai jumlah ' Quarters ' (berdasarkan tahun kalender) dan ditampilkan di kolom "DaysSinceSale". mengembalikan selisih antara tanggal sistem dan "DateofSale" sebagai jumlah ' bulan ' dan ditampilkan di kolom "DaysSinceSale". |
|
Pilih DateDiff ("y", [DateofSale], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateofSale" sebagai jumlah ' hari ' dan ditampilkan di kolom "DaysSinceSale". |
|
Pilih DateDiff ("d", [DateofSale], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateofSale" sebagai jumlah ' hari ' dan ditampilkan di kolom "DaysSinceSale". |
|
Pilih DateDiff ("w", [DateofSale], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateofSale" sebagai jumlah ' hari kerja ' dan ditampilkan di kolom "DaysSinceSale". Jika "DateofSale" jatuh pada hari Senin, DateDiff menghitung jumlah hari Senin hingga tanggal sistem. Ini menghitung tanggal sistem tetapi bukan nilai dalam "DateofSale". |
|
Pilih DateDiff ("WW", [DateofSale], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateofSale" sebagai jumlah "kalender minggu" dan ditampilkan di kolom "DaysSinceSale". Ini menghitung jumlah hari Minggu antara "DateofSale" dan "tanggal sistem". Ini akan menghitung tanggal sistem jika jatuh pada hari Minggu; tapi tidak menghitung "DateofSale", meskipun tidak jatuh pada hari Minggu. |
|
Pilih DateDiff ("h", [DateTime], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateTime" sebagai jumlah ' jam ' dan ditampilkan di kolom "DaysSinceSale". |
|
Pilih DateDiff ("n", [DateTime], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateTime" sebagai jumlah ' menit ' dan ditampilkan di kolom "DaysSinceSale". |
|
Pilih DateDiff ("s", [DateTime], date ()) sebagai DaysSinceSale dari ProductSales; |
Mengembalikan selisih antara tanggal sistem dan "DateTime" sebagai jumlah ' detik ' dan ditampilkan di kolom "DaysSinceSale". |
Contoh ekspresi
Menggunakan fungsi DateDiff dalam ekspresi Anda bisa menggunakan fungsi DateDiff di mana saja Anda bisa menggunakan ekspresi. Misalnya, Anda memiliki formulir yang Anda gunakan untuk memenuhi pesanan pelanggan. Dalam tabel pesanan, Anda memiliki bidang bernama Receivesebelum yang berisi tanggal pelanggan harus menerima pesanan. Anda bisa menggunakan fungsi DateDiff dengan kotak teks pada formulir untuk menampilkan jumlah hari tersisa sebelum pesanan harus dikirim.
Dengan asumsi memerlukan waktu 10 hari untuk mengirim pesanan apa pun, Anda mengatur properti sumber kontrol dari kotak teks sebagai berikut:
= DateDiff ("d", Now (), [pesanan]. [ ReceiveBefore])-10
Saat Anda membuka formulir dalam tampilan formulir, kotak teks menampilkan jumlah hari tersisa sebelum pesanan harus dikirim. Jika ada kurang dari 10 hari yang tersisa sebelum pelanggan harus menerima pesanan, angka dalam kotak teks bersifat negatif dan menunjukkan berapa hari yang terlambat dari pesanan jika dikirim dengan segera.
Contoh VBA
Menggunakan fungsi DateDiff dalam kode VBA
Contoh ini menggunakan fungsi DateDiff untuk menampilkan jumlah hari antara tanggal yang ditentukan dan hari ini.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg
