Fungsi DateDiff

Penting: Artikel ini adalah terjemahan mesin, lihat penafian. Temukan versi bahasa Inggris artikel di sini sebagai rujukan Anda.

Mengembalikan varian (panjang) menentukan angka interval waktu antara dua tanggal yang ditentukan.

Lihat beberapa contoh

Sintaks

DateDiff ( interval date1, date2 [, firstdayofweek] [, firstweekofyear] )

Sintaks fungsi DateDiff memiliki argumen ini:

Tips: Dalam Access 2010, penyusun ekspresi memiliki IntelliSense, sehingga Anda bisa melihat apa argumen ekspresi Anda memerlukan.

Argumen

Deskripsi

interval

Diperlukan. Ekspresi string yang interval waktu yang Anda gunakan untuk menghitung selisih antara date1 dan date2.

date1, date2

Diperlukan. Varian (Tanggal). Dua tanggal yang ingin Anda gunakan dalam perhitungan.

firstdayofweek

Opsional. konstanta yang menetapkan hari pertama dalam seminggu. Jika tidak ditentukan, minggu diasumsikan.

firstweekofyear

Opsional. Konstanta yang menentukan minggu pertama dalam setahun. Jika tidak ditentukan, pertama dalam seminggu diasumsikan minggu di mana 1 Januari terjadi.


Pengaturan

Interval argumen memiliki pengaturan ini:

Pengaturan

Deskripsi

tttt

Tahun

q

Kuartal

m

Bulan

y

Hari dalam setahun

d

Hari

w

Hari dalam seminggu

WW

Minggu

h

Jam

n

Menit

s

Detik


Atas halaman

Argumen firstdayofweek memiliki pengaturan ini:

Konstanta

Nilai

Deskripsi

vbUseSystem

0

Gunakan pengaturan NLS API.

vbSunday

1

Minggu (default)

vbMonday

2

Senin

vbTuesday

3

Selasa

vbWednesday

4

Rabu

vbThursday

5

Kamis

vbFriday

6

Jumat

vbSaturday

7

Sabtu


Konstanta

Nilai

Deskripsi

vbUseSystem

0

Gunakan pengaturan NLS API.

vbFirstJan1

1

Mulai dengan minggu di mana 1 Januari terjadi (default).

vbFirstFourDays

2

Mulai dengan pertama dalam seminggu yang memiliki setidaknya empat hari tahun baru.

vbFirstFullWeek

3

Mulai dengan seminggu penuh pertama dalam setahun.


Keterangan

Anda bisa menggunakan fungsi DateDiff untuk menentukan berapa banyak interval waktu yang ditentukan ada di antara dua tanggal. Misalnya, Anda mungkin menggunakan DateDiff untuk menghitung jumlah hari antara dua tanggal, atau jumlah minggu antara hari dan akhir tahun.

Untuk menghitung jumlah hari antara date1 dan date2, Anda bisa menggunakan baik hari setahun ("y") atau hari ("d"). Saat interval Weekday ("w"), DateDiff mengembalikan jumlah minggu antara dua tanggal. Jika date1 jatuh pada hari Senin, DateDiff menghitung jumlah hari Senin sampai date2. Menghitung date2 tetapi tidak date1. Jika interval minggu ("ww"), namun, fungsi DateDiff mengembalikan jumlah minggu-minggu kalender antara dua tanggal. Menghitung jumlah hari Minggu antara date1 dan date2. DateDiff menghitung date2 jika jatuh pada hari Minggu; tapi tidak dihitung date1, bahkan jika berada pada hari Minggu.

Jika date1 mengacu ke titik yang lebih baru di waktu dibandingkan date2, fungsi DateDiff mengembalikan angka negatif.

Argumen firstdayofweek mempengaruhi perhitungan yang menggunakan simbol interval "w" dan "ww".

Jika date1 atau date2terbaca sebagai tanggal, tahun tertentu menjadi bagian permanen tanggal tersebut. Namun, jika date1 atau date2 dimasukkan dalam tanda kutip ganda (""), dan Anda menghilangkan tahun, tahun ini disisipkan dalam kode Anda setiap kali date1 atau date2 ekspresi yang dievaluasi. Ini memungkinkan untuk menulis kode yang dapat digunakan pada tahun yang berbeda.

Saat membandingkan 31 Desember 1 Januari tahun segera berhasil, DateDiff tahun ("yyyy") mengembalikan 1, meskipun hanya hari telah berlalu.

Catatan: Untuk date1 dan date2, jika pengaturan properti kalender Gregorian, tanggal disediakan harus Gregorian. Jika kalender Hijriah, tanggal disediakan harus Hijriah.

Atas halaman

Contoh

Gunakan fungsi DateDiff dalam ekspresi     Anda bisa menggunakan fungsi DateDiff mana pun Anda bisa menggunakan ekspresi. Misalnya, Anda memiliki bentuk yang Anda gunakan untuk memenuhi pesanan pelanggan. Di tabel pesanan, Anda memiliki bidang bernama ReceiveBefore yang berisi tanggal yang pelanggan harus menerima urutan. Anda bisa menggunakan fungsi DateDiff dengan kotak teks pada formulir untuk menampilkan jumlah hari yang tersisa sebelum urutan harus mengirimkan.

Dengan menganggap dibutuhkan sepuluh hari untuk mengirimkan susunan apa pun, Anda mengatur properti Sumber kontrol dari kotak teks sebagai berikut:

= DateDiff("d", Now(), [Orders].[ ReceiveBefore]) -10

Ketika Anda membuka formulir dalam tampilan formulir, kotak teks menampilkan jumlah hari yang tersisa sebelum urutan harus mengirimkan. Jika terdapat kurang dari 10 hari kiri sebelum pelanggan harus menerima urutan, angka di kotak teks negatif dan mengindikasikan berapa hari akhir urutan akan jika dikirim langsung.

Menggunakan fungsi DateDiff dalam kode VBA   

Catatan: Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA). Untuk informasi lebih lanjut 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 menggunakan fungsi DateDiff untuk menampilkan jumlah hari antara tanggal 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

Catatan: Penafian Terjemahan Mesin: Artikel ini telah diterjemahan oleh sistem komputer tanpa campur tangan manusia. Microsoft menawarkan terjemahan mesin ini untuk membantu pengguna yang bukan penutur bahasa Inggris agar dapat menikmati konten tentang produk, layanan, dan teknologi Microsoft. Karena artikel ini diterjemahkan oleh mesin, mungkin akan terdapat kesalahan kosa kata, sintaksis, atau tata bahasa.

Kembangkan keterampilan 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.

×