DateAndTime.DatePart Metode

Definisi

Ruang nama:: Microsoft.VisualBasic

Rakitan:: Microsoft.VisualBasic.dll

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

Nama	Deskripsi
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Mengembalikan nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu `Date` .
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Mengembalikan nilai yang berisi komponen yang ditentukan dari nilai tertentu `Date` .

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

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

Required. Nilai DateInterval enumerasi atau ekspresi string yang mewakili bagian dari nilai tanggal/waktu yang ingin Anda kembalikan.

DateValue: DateTime

Required. Nilai Date yang ingin Anda evaluasi.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Nilai yang dipilih dari FirstDayOfWeek enumerasi yang menentukan hari pertama dalam seminggu. Jika tidak ditentukan, Sunday digunakan.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Nilai yang dipilih dari FirstWeekOfYear enumerasi yang menentukan minggu pertama dalam setahun. Jika tidak ditentukan, Jan1 digunakan.

Mengembalikan

Int32

Nilai bilangan bulat yang berisi komponen yang ditentukan dari nilai tertentu Date .

Pengecualian

ArgumentException

Interval tidak valid.

InvalidCastException

DateValue tidak dapat dipaksa untuk Date.

Contoh

Contoh ini mengambil tanggal dan, menggunakan DatePart fungsi , menampilkan seperempat tahun di mana itu 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 yang 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	Year

Argumen FirstDayOfWeekValue dapat memiliki salah satu pengaturan berikut.

Nilai enumerasi	Value	Description
`FirstDayOfWeek.System`	0	Hari pertama dalam minggu 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	Tuesday
`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	Value	Description
`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

Berlaku untuk

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

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);

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