Mengembalikan Varian (Bilangan Bulat) yang berisi bagian tertentu dari tanggal yang ditetapkan.
|
Peringatan Ada masalah dengan penggunaan fungsi ini. Senin terakhir dalam beberapa tahun kalender dapat dikembalikan sebagai minggu 53 ketika seharusnya minggu 1. Untuk informasi selengkapnya dan solusinya, lihat Memformat atau fungsi DatePart dapat mengembalikan nomor minggu yang salah untuk Senin tahun lalu. |
Sintaks
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
Sintaks fungsi DatePart memiliki argumen ini:
|
Argumen |
Deskripsi |
|
interval |
Diperlukan. Ekspresi string yang merupakan interval waktu yang ingin Anda kembalikan. |
|
date |
Diperlukan. Nilai Varian (Tanggal) yang ingin Anda evaluasi. |
|
firstdayofweek |
Opsional. konstanta yang menentukan hari pertama dalam seminggu. Jika tidak ditentukan, Minggu dianggap sebagai hari pertama dalam seminggu. |
|
firstdayofyear |
Opsional. 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. |
|
vbSunday |
1 |
Minggu (default) |
|
vbMonday |
2 |
Senin |
|
vbTuesday |
3 |
Selasa |
|
vbWednesday |
4 |
Rabu |
|
vb Kamis |
5 |
Kamis |
|
vbFriday |
6 |
Jumat |
|
vbSaturday |
7 |
Sabtu |
Argumen firstweekofyear memiliki pengaturan ini:
|
Konstanta |
Nilai |
Deskripsi |
|
vbUseSystem |
0 |
Gunakan pengaturan API NLS. |
|
vbFirstJan1 |
1 |
Mulai dengan minggu di mana 1 Januari terjadi (default). |
|
vbFirstFourDays |
2 |
Mulailah dengan minggu pertama yang memiliki setidaknya empat hari dalam tahun baru. |
|
vbFirstFullWeek |
3 |
Mulai dengan minggu penuh pertama dalam setahun. |
Keterangan
Anda dapat menggunakan fungsi DatePart untuk mengevaluasi tanggal dan mengembalikan interval waktu tertentu. Misalnya, Anda mungkin menggunakan DatePart untuk menghitung hari dalam seminggu atau jam saat ini.
Argumen firstdayofweek mempengaruhi perhitungan yang menggunakan simbol interval "w" dan "ww".
Jika date adalah terbaca sebagai tanggal, tahun yang ditentukan menjadi bagian permanen dari tanggal tersebut. Namun, jika tanggal dimasukkan dalam tanda kutip ganda (" "), dan Anda menghilangkan tahun, tahun saat ini disisipkan dalam kode Anda setiap kali ekspresi tanggal dievaluasi. Ini memungkinkan untuk menulis kode yang dapat digunakan dalam tahun yang berbeda.
Catatan: Untuk tanggal, jika pengaturan properti Kalender adalah Gregorian, tanggal yang disediakan harus gregorian. Jika kalender adalah Hijriyah, tanggal yang disediakan harus Hijriyah.
Bagian tanggal yang dikembalikan berada dalam satuan periode waktu kalender Arab saat ini. Misalnya, jika kalender saat ini adalah Hijriah dan bagian tanggal yang akan dikembalikan adalah tahun, nilai tahun adalah tahun Hijriyah.
Contoh kueri
|
Ekspresi |
Hasil |
|
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
Mengembalikan 'Tahun' dari nilai tanggal bidang "DateofSale". |
|
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Mengembalikan 'Kuartal' (berdasarkan tahun kalender) dari nilai tanggal bidang "DateofSale". |
|
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Mengembalikan 'Hari Tahun' (1 hingga 365) dari nilai tanggal bidang "DateofSale". |
|
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Mengembalikan 'Hari' dari nilai tanggal bidang "DateofSale". |
|
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Mengembalikan 'Hari Kerja' (dari 1 sampai 7 di mana 1 mewakili Hari Minggu) dari nilai tanggal bidang "DateofSale". |
|
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Mengembalikan 'Angka minggu' (dari 1 hingga 52) dari nilai tanggal bidang "DateofSale". |
|
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Mengembalikan 'Jam' dari nilai tanggal bidang "DateTime". |
|
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
Mengembalikan 'Menit' dari nilai tanggal bidang "DateTime". |
|
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
Mengembalikan 'detik' dari nilai tanggal bidang "DateTime". |
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 memerlukan tanggal dan, menggunakan fungsi DatePart , menampilkan kuartal dalam setahun tempatnya terjadi.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
