Fungsi DatePart

Mengembalikan Varian (Bilangan Bulat) yang berisi bagian tertentu dari tanggal yang ditetapkan.

Perhatian    Ada masalah dengan penggunaan fungsi ini. Hari Senin yang lalu dalam beberapa tahun kalender bisa dikembalikan sebagai minggu 53 saat harus seminggu 1. Untuk informasi lebih lanjut dan solusi, lihat format atau fungsi DatePart bisa mengembalikan nomor minggu yang salah untuk Senin terakhir dalam setahun.

Sintaks

Datepart ( interval, tanggal [, 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

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

Argumen firstweekofyear memiliki pengaturan ini:

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 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 penghitungan 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 diapit dalam tanda kutip ganda (""), dan Anda menghilangkan tahun, tahun saat ini disisipkan dalam kode Anda setiap kali ekspresi tanggal dievaluasi. Hal 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 Hijriah, tanggal yang disediakan harus berupa Hijriah.

Bagian tanggal yang dikembalikan berada dalam satuan periode waktu dari kalender Arab saat ini. Misalnya, jika kalender saat ini adalah Hijriah dan bagian tanggal yang dikembalikan adalah tahun, nilai tahun adalah tahun Hijriah.

Contoh kueri

Ekspresi

Hasil

Pilih DatePart ("yyyy", [DateofSale]) sebagai NewDate dari ProductSales;

Mengembalikan ' Year ' dari nilai tanggal bidang "DateofSale".

Pilih DatePart ("q", [DateofSale]) sebagai NewDate dari ProductSales;

Mengembalikan ' kuartal ' (berdasarkan tahun kalender) dari nilai tanggal bidang "DateofSale".

Pilih DatePart ("y", [DateofSale]) sebagai NewDate dari ProductSales;

Mengembalikan ' hari tahun ' (1 hingga 365) dari nilai tanggal bidang "DateofSale".

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

Mengembalikan ' hari ' dari nilai tanggal bidang "DateofSale".

Pilih DatePart ("w", [DateofSale]) sebagai NewDate dari ProductSales;

Mengembalikan ' weekday ' (dari 1 sampai 7 di mana 1 mewakili minggu) dari nilai tanggal bidang "DateofSale".

Pilih DatePart ("WW", [DateofSale]) sebagai NewDate dari ProductSales;

Mengembalikan ' jumlah minggu ' (dari 1 hingga 52) dari nilai tanggal bidang "DateofSale".

Pilih DatePart ("h", [DateTime]) sebagai NewDate dari ProductSales;

Mengembalikan ' Hour ' dari nilai tanggal bidang "DateTime".

Pilih DatePart ("n", [DateTime]) sebagai NewDate dari ProductSales;

Mengembalikan ' minutes ' dari nilai tanggal bidang "DateTime".

Pilih DatePart ("s", [DateTime]) sebagai NewDate dari ProductSales;

Mengembalikan ' detik ' dari nilai tanggal bidang "Tanggalwaktu".

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 dan, menggunakan fungsi Datepart , menampilkan kuartal dalam setahun yang terjadi.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Lihat Juga

Memilih fungsi tanggal yang benar

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.

×