DateAndTime.DatePart Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu Date .
Overload
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Mengembalikan nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Mengembalikan nilai yang berisi komponen yang ditentukan dari nilai tertentu |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Sumber:
- DateAndTime.vb
- Sumber:
- DateAndTime.vb
- Sumber:
- DateAndTime.vb
Mengembalikan nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu Date .
public static int DatePart (Microsoft.VisualBasic.DateInterval Interval, DateTime DateValue, Microsoft.VisualBasic.FirstDayOfWeek FirstDayOfWeekValue = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear FirstWeekOfYearValue = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);static member DatePart : Microsoft.VisualBasic.DateInterval * DateTime * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> intPublic Function DatePart (Interval As DateInterval, DateValue As DateTime, Optional FirstDayOfWeekValue As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional FirstWeekOfYearValue As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As IntegerParameter
- Interval
- DateInterval
Wajib diisi. Nilai DateInterval enumerasi atau ekspresi string yang mewakili bagian dari nilai tanggal/waktu yang ingin Anda kembalikan.
- DateValue
- DateTime
Wajib diisi. Nilai Date yang ingin Anda evaluasi.
- FirstDayOfWeekValue
- FirstDayOfWeek
Opsional. Nilai yang dipilih dari FirstDayOfWeek enumerasi yang menentukan hari pertama dalam seminggu. Jika tidak ditentukan, Sunday digunakan.
- FirstWeekOfYearValue
- FirstWeekOfYear
Opsional. Nilai yang dipilih dari FirstWeekOfYear enumerasi yang menentukan minggu pertama dalam setahun. Jika tidak ditentukan, Jan1 digunakan.
Mengembalikan
Nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu Date .
Pengecualian
Interval tidak valid.
DateValue tidak dapat dipaksa untuk Date.
Contoh
Contoh ini mengambil tanggal dan, menggunakan DatePart fungsi , menampilkan seperempat tahun di mana ia terjadi.
Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)
' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)
' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)
Keterangan
Anda dapat menggunakan DatePart fungsi untuk mengevaluasi nilai tanggal/waktu dan mengembalikan komponen tertentu. Misalnya, Anda dapat menggunakan DatePart untuk menghitung hari dalam seminggu atau jam saat ini.
Jika Anda memilih DateInterval.Weekday untuk Interval argumen , nilai yang dikembalikan konsisten dengan nilai FirstDayOfWeek enumerasi. Jika Anda memilih DateInterval.WeekOfYear, DatePart menggunakan Calendar kelas System.Globalization dan CultureInfo namespace layanan untuk menentukan pengaturan Anda saat ini.
Argumen FirstDayOfWeekValue memengaruhi perhitungan yang menggunakan DateInterval.Weekday pengaturan dan DateInterval.WeekOfYearInterval . Argumen FirstWeekOfYearValue memengaruhi perhitungan yang menentukan DateInterval.WeekOfYear untuk Interval.
Karena setiap Date nilai didukung oleh DateTime struktur, metodenya memberi Anda opsi tambahan dalam mengambil bagian tanggal/waktu. Misalnya, Anda dapat memperoleh seluruh nilai Date tanggal variabel, dengan nilai waktu diatur ke tengah malam, sebagai berikut:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Argumen Interval dapat memiliki salah satu pengaturan berikut.
| Nilai enumerasi | String | Bagian dari nilai tanggal/waktu yang akan dikembalikan |
|---|---|---|
DateInterval.Day |
d | Hari dalam sebulan (1 hingga 31) |
DateInterval.DayOfYear |
y | Hari dalam setahun (1 hingga 366) |
DateInterval.Hour |
h | Jam |
DateInterval.Minute |
n | Menit |
DateInterval.Month |
m | Bulan |
DateInterval.Quarter |
q | Kuartal |
DateInterval.Second |
s | Detik |
DateInterval.Weekday |
w | Hari dalam seminggu (1 hingga 7) |
DateInterval.WeekOfYear |
ww | Minggu dalam setahun (1 hingga 53) |
DateInterval.Year |
yyyy | Tahun |
Argumen FirstDayOfWeekValue dapat memiliki salah satu pengaturan berikut.
| Nilai enumerasi | Nilai | Deskripsi |
|---|---|---|
FirstDayOfWeek.System |
0 | Hari pertama dalam seminggu yang ditentukan dalam pengaturan sistem |
FirstDayOfWeek.Sunday |
1 | Minggu (default) |
FirstDayOfWeek.Monday |
2 | Senin (sesuai dengan standar ISO 8601, bagian 3.17) |
FirstDayOfWeek.Tuesday |
3 | Selasa |
FirstDayOfWeek.Wednesday |
4 | Rabu |
FirstDayOfWeek.Thursday |
5 | Kamis |
FirstDayOfWeek.Friday |
6 | Jumat |
FirstDayOfWeek.Saturday |
7 | Sabtu |
Argumen FirstWeekOfYearValue dapat memiliki salah satu pengaturan berikut.
| Nilai enumerasi | Nilai | Deskripsi |
|---|---|---|
FirstWeekOfYear.System |
0 | Minggu pertama tahun yang ditentukan dalam pengaturan sistem |
FirstWeekOfYear.Jan1 |
1 | Minggu di mana 1 Januari terjadi (default) |
FirstWeekOfYear.FirstFourDays |
2 | Minggu yang memiliki setidaknya empat hari di tahun baru (sesuai dengan standar ISO 8601, bagian 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Minggu penuh pertama di tahun baru |
Lihat juga
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Ringkasan Tipe Data (Visual Basic)
Berlaku untuk
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Sumber:
- DateAndTime.vb
- Sumber:
- DateAndTime.vb
- Sumber:
- DateAndTime.vb
Mengembalikan nilai yang berisi komponen yang ditentukan dari nilai tertentu Date .
public static int DatePart (string Interval, object? DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);public static int DatePart (string Interval, object DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);static member DatePart : string * obj * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> intPublic Function DatePart (Interval As String, DateValue As Object, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As IntegerParameter
- Interval
- String
Wajib diisi. Nilai DateInterval enumerasi atau ekspresi string yang mewakili bagian dari nilai tanggal/waktu yang ingin Anda kembalikan.
- DateValue
- Object
Wajib diisi. Nilai Date yang ingin Anda evaluasi.
- DayOfWeek
- FirstDayOfWeek
Opsional. Nilai yang dipilih dari FirstDayOfWeek enumerasi yang menentukan hari pertama dalam seminggu. Jika tidak ditentukan, Sunday digunakan.
- WeekOfYear
- FirstWeekOfYear
Opsional. Nilai yang dipilih dari FirstWeekOfYear enumerasi yang menentukan minggu pertama dalam setahun. Jika tidak ditentukan, Jan1 digunakan.
Mengembalikan
Nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu Date .
Pengecualian
Interval tidak valid.
DateValue tidak dapat dipaksa untuk Date.
Contoh
Contoh ini mengambil tanggal dan, menggunakan DatePart fungsi , menampilkan seperempat tahun di mana ia terjadi.
Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)
' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)
' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)
Keterangan
Anda dapat menggunakan DatePart fungsi untuk mengevaluasi nilai tanggal/waktu dan mengembalikan komponen tertentu. Misalnya, Anda dapat menggunakan DatePart untuk menghitung hari dalam seminggu atau jam saat ini.
Jika Anda memilih DateInterval.Weekday untuk Interval argumen , nilai yang dikembalikan konsisten dengan nilai FirstDayOfWeek enumerasi. Jika Anda memilih DateInterval.WeekOfYear, DatePart menggunakan Calendar kelas System.Globalization dan CultureInfo namespace layanan untuk menentukan pengaturan Anda saat ini.
Argumen FirstDayOfWeekValue memengaruhi perhitungan yang menggunakan DateInterval.Weekday pengaturan dan DateInterval.WeekOfYearInterval . Argumen FirstWeekOfYearValue memengaruhi perhitungan yang menentukan DateInterval.WeekOfYear untuk Interval.
Karena setiap Date nilai didukung oleh DateTime struktur, metodenya memberi Anda opsi tambahan dalam mengambil bagian tanggal/waktu. Misalnya, Anda dapat memperoleh seluruh nilai Date tanggal variabel, dengan nilai waktu diatur ke tengah malam, sebagai berikut:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Argumen Interval dapat memiliki salah satu pengaturan berikut.
| Nilai enumerasi | String | Bagian dari nilai tanggal/waktu yang akan dikembalikan |
|---|---|---|
DateInterval.Day |
d | Hari dalam sebulan (1 hingga 31) |
DateInterval.DayOfYear |
y | Hari dalam setahun (1 hingga 366) |
DateInterval.Hour |
h | Jam |
DateInterval.Minute |
n | Menit |
DateInterval.Month |
m | Bulan |
DateInterval.Quarter |
q | Kuartal |
DateInterval.Second |
s | Detik |
DateInterval.Weekday |
w | Hari dalam seminggu (1 hingga 7) |
DateInterval.WeekOfYear |
ww | Minggu dalam setahun (1 hingga 53) |
DateInterval.Year |
yyyy | Tahun |
Argumen FirstDayOfWeekValue dapat memiliki salah satu pengaturan berikut.
| Nilai enumerasi | Nilai | Deskripsi |
|---|---|---|
FirstDayOfWeek.System |
0 | Hari pertama dalam seminggu yang ditentukan dalam pengaturan sistem |
FirstDayOfWeek.Sunday |
1 | Minggu (default) |
FirstDayOfWeek.Monday |
2 | Senin (sesuai dengan standar ISO 8601, bagian 3.17) |
FirstDayOfWeek.Tuesday |
3 | Selasa |
FirstDayOfWeek.Wednesday |
4 | Rabu |
FirstDayOfWeek.Thursday |
5 | Kamis |
FirstDayOfWeek.Friday |
6 | Jumat |
FirstDayOfWeek.Saturday |
7 | Sabtu |
Argumen FirstWeekOfYearValue dapat memiliki salah satu pengaturan berikut.
| Nilai enumerasi | Nilai | Deskripsi |
|---|---|---|
FirstWeekOfYear.System |
0 | Minggu pertama tahun yang ditentukan dalam pengaturan sistem |
FirstWeekOfYear.Jan1 |
1 | Minggu di mana 1 Januari terjadi (default) |
FirstWeekOfYear.FirstFourDays |
2 | Minggu yang memiliki setidaknya empat hari di tahun baru (sesuai dengan standar ISO 8601, bagian 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Minggu penuh pertama di tahun baru |
Lihat juga
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Ringkasan Tipe Data (Visual Basic)
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk