Mengembalikan Varian (Tanggal) untuk tahun, bulan, dan hari yang ditentukan.
Sintaks
DateSerial ( year, month, day )
Peringatan Pastikan argumen berada dalam rentang nilai yang benar. Argumen yang tidak valid dapat menghasilkan hasil yang salah.
Sintaks fungsi DateSerial memiliki argumen ini:
Argumen |
Deskripsi |
tahun |
Diperlukan. Bilangan bulat. Angka antara 100 dan 9999, inklusif, atau ekpresi numerik. |
bulan |
Diperlukan. Bilangan bulat. Ekpresi numerik apa pun. |
hari |
Diperlukan. Bilangan bulat. Ekpresi numerik apa pun. |
Keterangan
Untuk menentukan tanggal, seperti 31 Desember 1991, rentang angka untuk setiapargumenDateSerial harus berada dalam rentang yang diterima untuk unit tersebut; yaitu, 1–31 untuk hari dan 1–12 untuk bulan. Namun, Anda juga dapat menentukan tanggal relatif untuk setiap argumen menggunakan ekspresi numerik apa pun yang menunjukkan jumlah hari, bulan, atau tahun sebelum atau sesudah tanggal tertentu.
Contoh berikut ini menggunakan ekspresi numerik, bukan angka tanggal absolut. Di sini fungsi DateSerial mengembalikan tanggal yang merupakan hari sebelum hari pertama (1 - 1), dua bulan sebelum Agustus (8 - 2), 10 tahun sebelum 1990 (1990 - 10); dengan kata lain, 31 Mei 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Tahun dua digit untuk argumen tahun diinterpretasikan berdasarkan pengaturan komputer yang ditentukan pengguna. Pengaturan default adalah bahwa nilai antara 0 dan 29, inklusif, diinterpretasikan sebagai tahun 2000–2029. Nilai default antara 30 dan 99 diinterpretasikan sebagai tahun 1930–1999. Untuk argumen semua tahun lainnya, gunakan tahun empat digit (misalnya, 1800).
Versi Windows yang lebih lama dari Windows 2000 menginterpretasikan tahun dua digit berdasarkan default yang dijelaskan di atas. Untuk memastikan fungsi mengembalikan nilai yang tepat, gunakan tahun empat digit.
Ketika argumen melebihi rentang yang diterima untuk argumen tersebut, argumen akan naik ke unit yang lebih besar berikutnya sebagaimana diperlukan. Misalnya, jika Anda menentukan 35 hari, itu dievaluasi sebagai satu bulan dan beberapa jumlah hari, tergantung pada di mana dalam tahun diterapkan. Jika argumen tunggal berada di luar rentang -32.768 hingga 32.767, kesalahan terjadi. Jika tanggal yang ditentukan oleh tiga argumen berada di luar rentang tanggal yang dapat diterima, kesalahan terjadi.
Catatan: Untuk tahun, bulan, dan hari, jika pengaturan properti Kalender adalah Gregorian, nilai yang disediakan diasumsikan sebagai Gregorian. Jika pengaturan properti Kalender adalah Hijriah, nilai yang disediakan diasumsikan sebagai Hijriah.
Bagian tanggal yang dikembalikan berada dalam satuan periode waktu kalender Visual Basic saat ini. Misalnya, jika kalender saat ini adalah Hijriah dan bagian tanggal yang akan dikembalikan adalah tahun, nilai tahun adalah tahun Hijriyah. Untuk tahun argumen, nilai antara 0 dan 99, inklusif, diinterpretasikan sebagai tahun 1400-1499. Untuk semua nilai tahun lainnya, gunakan tahun empat digit lengkap (misalnya, 1520).
Contoh kueri
Ekspresi |
Hasil |
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
Mengembalikan "tanggal" untuk tahun, bulan, dan hari yang ditentukan yang dimasukkan dalam argumen fungsi dan ditampilkan dalam kolom "NewDate". Hasil: "13/12/2018". |
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 menggunakan fungsi DateSerial untuk mengembalikan tanggal untuk tahun, bulan, dan hari tertentu.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.