DateAndTime.DatePart Yöntem

Tanım

Ad Alanı:: Microsoft.VisualBasic

Bütünleştirilmiş Kod:: Microsoft.VisualBasic.Core.dll

Bütünleştirilmiş Kod:: Microsoft.VisualBasic.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirli Date bir değerin belirtilen bileşenini içeren bir tamsayı değeri döndürür.

Aşırı Yüklemeler

Name	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Belirli `Date` bir değerin belirtilen bileşenini içeren bir tamsayı değeri döndürür.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Belirli `Date` bir değerin belirtilen bileşenini içeren bir değer döndürür.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Belirli Date bir değerin belirtilen bileşenini içeren bir tamsayı değeri döndürür.

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

Parametreler

Interval: DateInterval

Gerekli. DateInterval Döndürmek istediğiniz tarih/saat değerinin bölümünü temsil eden bir numaralandırma değeri veya dize ifadesi.

DateValue: DateTime

Gerekli. Değerlendirmek Date istediğiniz değer.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Numaralandırmadan FirstDayOfWeek seçilen ve haftanın ilk gününü belirten bir değer. Belirtilmezse kullanılır Sunday .

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Numaralandırmadan FirstWeekOfYear seçilen ve yılın ilk haftasını belirten bir değer. Belirtilmezse kullanılır Jan1 .

Döndürülenler

Int32

Belirli Date bir değerin belirtilen bileşenini içeren bir tamsayı değeri.

Özel durumlar

ArgumentException

Interval geçerli değil.

InvalidCastException

DateValue , ile Datezorlanmıyor.

Örnekler

Bu örnek bir tarih alır ve işlevini kullanarak DatePart , gerçekleştiği yılın üç aylık dönemini görüntüler.

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)

Açıklamalar

bir tarih/saat değerini değerlendirmek ve belirli bir bileşeni döndürmek için işlevini kullanabilirsiniz DatePart . Örneğin, haftanın gününü veya geçerli saati hesaplamak için kullanabilirsiniz DatePart .

Bağımsız değişkenini DateInterval.Weekday seçersenizInterval, döndürülen değer sabit listesi değerleriyle FirstDayOfWeek tutarlıdır. öğesini seçersenizDateInterval.WeekOfYearDatePart, geçerli ayarlarınızı belirlemek için ad alanının Calendar ve CultureInfo sınıflarını kullanırSystem.Globalization.

bağımsız FirstDayOfWeekValue değişkeni ve DateInterval.WeekdayDateInterval.WeekOfYear ayarlarını kullanan Interval hesaplamaları etkiler. FirstWeekOfYearValue bağımsız değişkeni için DateInterval.WeekOfYearbelirtilen Interval hesaplamaları etkiler.

Her Date değer bir DateTime yapı tarafından desteklendiğinden, yöntemleri size tarih/saat parçalarını alma konusunda ek seçenekler sağlar. Örneğin, saat değeri gece yarısı olarak ayarlanmış bir Date değişkenin tarih değerinin tamamını aşağıdaki gibi elde edebilirsiniz:

Dim CurrDatTim As Date = Now   ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.

Bağımsız Interval değişken aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	String	Döndürülecek tarih/saat değerinin parçası
`DateInterval.Day`	d	Ayın günü (1 ile 31 arasında)
`DateInterval.DayOfYear`	y	Yılın günü (1 ile 366 arasında)
`DateInterval.Hour`	h	Saat
`DateInterval.Minute`	n	Dakika
`DateInterval.Month`	m	Ay
`DateInterval.Quarter`	q	Üç aylık dönem
`DateInterval.Second`	s	Second
`DateInterval.Weekday`	w	Haftanın günü (1 ile 7 arasında)
`DateInterval.WeekOfYear`	Ww	Yılın haftası (1 ile 53 arasında)
`DateInterval.Year`	yyyy	Year

Bağımsız FirstDayOfWeekValue değişken aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Değer	Açıklama
`FirstDayOfWeek.System`	0	Sistem ayarlarında haftanın ilk günü belirtildi
`FirstDayOfWeek.Sunday`	1	Pazar (varsayılan)
`FirstDayOfWeek.Monday`	2	Pazartesi (ISO standardı 8601, bölüm 3.17 ile uyumludur)
`FirstDayOfWeek.Tuesday`	3	Tuesday
`FirstDayOfWeek.Wednesday`	4	Çarşamba
`FirstDayOfWeek.Thursday`	5	Perşembe
`FirstDayOfWeek.Friday`	6	Cuma
`FirstDayOfWeek.Saturday`	7	Cumartesi

Bağımsız FirstWeekOfYearValue değişken aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Değer	Açıklama
`FirstWeekOfYear.System`	0	Sistem ayarlarında yılın ilk haftası belirtildi
`FirstWeekOfYear.Jan1`	1	1 Ocak'ın gerçekleştiği hafta (varsayılan)
`FirstWeekOfYear.FirstFourDays`	2	Yeni yılda en az dört günü olan hafta (ISO standardı 8601, bölüm 3.17 ile uyumludur)
`FirstWeekOfYear.FirstFullWeek`	3	Yeni yılın ilk tam haftası

Ayrıca bkz.

Şunlara uygulanır

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Kaynak:: DateAndTime.vb

Belirli Date bir değerin belirtilen bileşenini içeren bir değer döndürür.

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