DateAndTime.DatePart Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

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

Aşırı Yüklemeler

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

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Kaynak:

DateAndTime.vb

Belirli bir Date değerinin 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. Döndürmek istediğiniz tarih/saat değerinin bölümünü temsil eden bir DateInterval numaralandırma değeri veya dize ifadesi.

DateValue

DateTime

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

FirstDayOfWeekValue

FirstDayOfWeek

Opsiyonel. FirstDayOfWeek numaralandırmasından seçilen ve haftanın ilk gününü belirten bir değer. Belirtilmezse, Sunday kullanılır.

FirstWeekOfYearValue

FirstWeekOfYear

Opsiyonel. FirstWeekOfYear numaralandırmasından seçilen ve yılın ilk haftasını belirten bir değer. Belirtilmezse, Jan1 kullanılır.

Döndürülenler

Int32

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

Özel durumlar

ArgumentException

Interval geçerli değil.

InvalidCastException

DateValue Dateiçin zorlanmıyor.

Örnekler

Bu örnek bir tarih alır ve DatePart işlevini kullanarak 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

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

Interval bağımsız değişkeni için DateInterval.Weekday seçerseniz, döndürülen değer FirstDayOfWeek sabit listesi değerleriyle tutarlıdır. DateInterval.WeekOfYearseçerseniz DatePart geçerli ayarlarınızı belirlemek için System.Globalization ad alanının Calendar ve CultureInfo sınıflarını kullanır.

FirstDayOfWeekValue bağımsız değişkeni, DateInterval.Weekday ve DateInterval.WeekOfYearInterval ayarlarını kullanan hesaplamaları etkiler. FirstWeekOfYearValue bağımsız değişkeni, Intervaliçin DateInterval.WeekOfYear belirten hesaplamaları etkiler.

Her Date değeri DateTime bir 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şkeninin 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.  

Interval bağımsız değişkeni aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Dizgi	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	Çeyrek
DateInterval.Second	s	Saniye
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	Yıl

FirstDayOfWeekValue bağımsız değişkeni aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Değer	Tarif
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	Salı
FirstDayOfWeek.Wednesday	4	Çarşamba
FirstDayOfWeek.Thursday	5	Perşembe
FirstDayOfWeek.Friday	6	Cuma
FirstDayOfWeek.Saturday	7	Cumartesi

FirstWeekOfYearValue bağımsız değişkeni aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Değer	Tarif
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.

• DateAdd
• DateDiff
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Veri Türü Özeti (Visual Basic)

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Kaynak:

DateAndTime.vb

Belirli bir Date değerinin 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);

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

Parametreler

Interval

String

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

DateValue

Object

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

DayOfWeek

FirstDayOfWeek

Opsiyonel. FirstDayOfWeek numaralandırmasından seçilen ve haftanın ilk gününü belirten bir değer. Belirtilmezse, Sunday kullanılır.

WeekOfYear

FirstWeekOfYear

Opsiyonel. FirstWeekOfYear numaralandırmasından seçilen ve yılın ilk haftasını belirten bir değer. Belirtilmezse, Jan1 kullanılır.

Döndürülenler

Int32

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

Özel durumlar

ArgumentException

Interval geçersiz.

InvalidCastException

DateValue Dateiçin zorlanmıyor.

Örnekler

Bu örnek bir tarih alır ve DatePart işlevini kullanarak 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

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

Interval bağımsız değişkeni için DateInterval.Weekday seçerseniz, döndürülen değer FirstDayOfWeek sabit listesi değerleriyle tutarlıdır. DateInterval.WeekOfYearseçerseniz DatePart geçerli ayarlarınızı belirlemek için System.Globalization ad alanının Calendar ve CultureInfo sınıflarını kullanır.

FirstDayOfWeekValue bağımsız değişkeni, DateInterval.Weekday ve DateInterval.WeekOfYearInterval ayarlarını kullanan hesaplamaları etkiler. FirstWeekOfYearValue bağımsız değişkeni, Intervaliçin DateInterval.WeekOfYear belirten hesaplamaları etkiler.

Her Date değeri DateTime bir 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şkeninin 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.  

Interval bağımsız değişkeni aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Dizgi	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	Çeyrek
DateInterval.Second	s	Saniye
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	Yıl

FirstDayOfWeekValue bağımsız değişkeni aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Değer	Tarif
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	Salı
FirstDayOfWeek.Wednesday	4	Çarşamba
FirstDayOfWeek.Thursday	5	Perşembe
FirstDayOfWeek.Friday	6	Cuma
FirstDayOfWeek.Saturday	7	Cumartesi

FirstWeekOfYearValue bağımsız değişkeni aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Değer	Tarif
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.

• DateAdd
• DateDiff
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Veri Türü Özeti (Visual Basic)