DateAndTime.DatePart Yöntem
Tanım
Ö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
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Belirli |
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Belirli |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- 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
Gereklidir. 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
Gereklidir. Değerlendirmek Date
istediğiniz değer.
- FirstDayOfWeekValue
- FirstDayOfWeek
İsteğe bağlı. Numaralandırmadan FirstDayOfWeek seçilen ve haftanın ilk gününü belirten bir değer. Belirtilmezse Sunday kullanılır.
- FirstWeekOfYearValue
- FirstWeekOfYear
İsteğe bağlı. Numaralandırmadan FirstWeekOfYear seçilen ve yılın ilk haftasını belirten bir değer. Belirtilmezse Jan1 kullanılır.
Döndürülenler
Belirli Date
bir değerin belirtilen bileşenini içeren bir tamsayı değeri.
Özel durumlar
Interval
geçerli değil.
DateValue
, ile zorlanmıyor Date
.
Örnekler
Bu örnek bir tarih alır ve işlevini kullanarak DatePart
bu tarihin 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 Interval
seçersenizDateInterval.Weekday
, döndürülen değer sabit listesi değerleriyle FirstDayOfWeek
tutarlıdır. öğesini seçersenizDateInterval.WeekOfYear
, DatePart
geçerli ayarlarınızı belirlemek için ad alanının System.Globalization ve CultureInfo sınıflarını kullanırCalendar.
bağımsız FirstDayOfWeekValue
değişkeni ve DateInterval.WeekOfYear
Interval
ayarlarını kullanan DateInterval.Weekday
hesaplamaları etkiler. bağımsız FirstWeekOfYearValue
değişkeni için Interval
belirtilen DateInterval.WeekOfYear
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 | Dize | Döndürülecek tarih/saat değerinin bir bölümü |
---|---|---|
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 | 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 | Yıl |
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 belirtilen haftanın ilk günü |
FirstDayOfWeek.Sunday |
1 | Pazar (varsayılan) |
FirstDayOfWeek.Monday |
2 | Pazartesi (ISO standart 8601, bölüm 3.17 ile uyumlu) |
FirstDayOfWeek.Tuesday |
3 | Salı |
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 belirtilen yılın ilk haftası |
FirstWeekOfYear.Jan1 |
1 | 1 Ocak oluştuğu hafta (varsayılan) |
FirstWeekOfYear.FirstFourDays |
2 | Yeni yılda en az dört günü olan hafta (ISO standart 8601, 3.17 bölüm ile uyumlu) |
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)
Şunlara uygulanır
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- 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
Parametreler
- Interval
- String
Gereklidir. 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
- Object
Gereklidir. Date
Değerlendirmek istediğiniz değer.
- DayOfWeek
- FirstDayOfWeek
İsteğe bağlı. Numaralandırmadan FirstDayOfWeek seçilen ve haftanın ilk gününü belirten bir değer. Belirtilmezse Sunday kullanılır.
- WeekOfYear
- FirstWeekOfYear
İsteğe bağlı. Numaralandırmadan FirstWeekOfYear seçilen ve yılın ilk haftasını belirten bir değer. Belirtilmezse Jan1 kullanılır.
Döndürülenler
Belirli Date
bir değerin belirtilen bileşenini içeren bir tamsayı değeri.
Özel durumlar
Interval
geçersizdir.
DateValue
, ile zorlanmıyor Date
.
Örnekler
Bu örnek bir tarih alır ve işlevini kullanarak DatePart
bu tarihin 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 Interval
seçersenizDateInterval.Weekday
, döndürülen değer sabit listesi değerleriyle FirstDayOfWeek
tutarlıdır. öğesini seçersenizDateInterval.WeekOfYear
, DatePart
geçerli ayarlarınızı belirlemek için ad alanının ve CultureInfo sınıflarını System.Globalization kullanırCalendar.
bağımsız FirstDayOfWeekValue
değişkeni ve DateInterval.WeekOfYear
Interval
ayarlarını kullanan DateInterval.Weekday
hesaplamaları etkiler. FirstWeekOfYearValue
bağımsız değişkeni için Interval
belirtilen DateInterval.WeekOfYear
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 | Dize | 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 | 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 | Yıl |
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 belirtilen haftanın ilk günü |
FirstDayOfWeek.Sunday |
1 | Pazar (varsayılan) |
FirstDayOfWeek.Monday |
2 | Pazartesi (ISO standart 8601, bölüm 3.17 ile uyumlu) |
FirstDayOfWeek.Tuesday |
3 | Salı |
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 belirtilen yılın ilk haftası |
FirstWeekOfYear.Jan1 |
1 | 1 Ocak oluştuğu hafta (varsayılan) |
FirstWeekOfYear.FirstFourDays |
2 | Yeni yılda en az dört günü olan hafta (ISO standart 8601, 3.17 bölüm ile uyumlu) |
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)
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin