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 -> int
Public 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 Integer
Parameter
- 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.WeekOfYear
Interval
. 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 -> int
Public 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 Integer
Parameter
- 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.WeekOfYear
Interval
. 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
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk