DateAndTime.DatePart Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca wartość całkowitą zawierającą określony składnik danej wartości Date.
Przeciążenia
| Nazwa | Opis |
|---|---|
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Zwraca wartość całkowitą zawierającą określony składnik danej wartości |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Zwraca wartość zawierającą określony składnik danej wartości |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
Zwraca wartość całkowitą zawierającą określony składnik danej wartości 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
Parametry
- Interval
- DateInterval
Wymagane. Wartość wyliczenia DateInterval lub wyrażenie ciągu reprezentujące część wartości daty/godziny, którą chcesz zwrócić.
- DateValue
- DateTime
Wymagane. Wartość Date, którą chcesz ocenić.
- FirstDayOfWeekValue
- FirstDayOfWeek
Fakultatywny. Wartość wybrana z wyliczenia FirstDayOfWeek, która określa pierwszy dzień tygodnia. Jeśli nie zostanie określony, zostanie użyta Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Fakultatywny. Wartość wybrana z wyliczenia FirstWeekOfYear, która określa pierwszy tydzień roku. Jeśli nie zostanie określony, zostanie użyta Jan1.
Zwraca
Wartość całkowita zawierająca określony składnik danej wartości Date.
Wyjątki
Interval jest nieprawidłowa.
DateValue nie jest coercible do Date.
Przykłady
Ten przykład przyjmuje datę i przy użyciu funkcji DatePart wyświetla kwartał roku, w którym występuje.
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)
Uwagi
Możesz użyć funkcji DatePart, aby ocenić wartość daty/godziny i zwrócić określony składnik. Na przykład możesz użyć DatePart do obliczenia dnia tygodnia lub bieżącej godziny.
Jeśli wybierzesz DateInterval.Weekday argumentu Interval, zwracana wartość jest zgodna z wartościami wyliczenia FirstDayOfWeek. Jeśli wybierzesz DateInterval.WeekOfYear, DatePart używa klas Calendar i CultureInfo przestrzeni nazw System.Globalization w celu określenia bieżących ustawień.
Argument FirstDayOfWeekValue ma wpływ na obliczenia korzystające z ustawień DateInterval.Weekday i DateInterval.WeekOfYearInterval. Argument FirstWeekOfYearValue ma wpływ na obliczenia, które określają DateInterval.WeekOfYear dla Interval.
Ponieważ każda wartość Date jest obsługiwana przez strukturę DateTime, jej metody zapewniają dodatkowe opcje pobierania części daty/godziny. Można na przykład uzyskać całą wartość daty zmiennej Date z wartością godziny ustawioną na północ w następujący sposób:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Argument Interval może mieć jedno z następujących ustawień.
| Wartość wyliczenia | Struna | Część wartości daty/godziny do zwrócenia |
|---|---|---|
DateInterval.Day |
d | Dzień miesiąca (od 1 do 31) |
DateInterval.DayOfYear |
y | Dzień roku (od 1 do 366) |
DateInterval.Hour |
h | Godzina |
DateInterval.Minute |
n | Minuta |
DateInterval.Month |
m | Miesiąc |
DateInterval.Quarter |
q | Ćwiartka |
DateInterval.Second |
s | Sekunda |
DateInterval.Weekday |
w | Dzień tygodnia (od 1 do 7) |
DateInterval.WeekOfYear |
Ww | Tydzień roku (od 1 do 53) |
DateInterval.Year |
yyyy | Rok |
Argument FirstDayOfWeekValue może mieć jedno z następujących ustawień.
| Wartość wyliczenia | Wartość | Opis |
|---|---|---|
FirstDayOfWeek.System |
0 | Pierwszy dzień tygodnia określony w ustawieniach systemowych |
FirstDayOfWeek.Sunday |
1 | Niedziela (wartość domyślna) |
FirstDayOfWeek.Monday |
2 | Poniedziałek (zgodny ze standardem ISO 8601, sekcja 3.17) |
FirstDayOfWeek.Tuesday |
3 | Wtorek |
FirstDayOfWeek.Wednesday |
4 | Środa |
FirstDayOfWeek.Thursday |
5 | Czwartek |
FirstDayOfWeek.Friday |
6 | Piątek |
FirstDayOfWeek.Saturday |
7 | Sobota |
Argument FirstWeekOfYearValue może mieć jedno z następujących ustawień.
| Wartość wyliczenia | Wartość | Opis |
|---|---|---|
FirstWeekOfYear.System |
0 | Pierwszy tydzień roku określony w ustawieniach systemowych |
FirstWeekOfYear.Jan1 |
1 | Tydzień, w którym występuje 1 stycznia (ustawienie domyślne) |
FirstWeekOfYear.FirstFourDays |
2 | Tydzień, który ma co najmniej cztery dni w nowym roku (zgodnie ze standardem ISO 8601, sekcja 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Pierwszy pełny tydzień w nowym roku |
Zobacz też
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- — podsumowanie typu danych (Visual Basic)
Dotyczy
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
Zwraca wartość zawierającą określony składnik danej wartości 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
Parametry
- Interval
- String
Wymagane. Wartość wyliczenia DateInterval lub wyrażenie ciągu reprezentujące część wartości daty/godziny, którą chcesz zwrócić.
- DateValue
- Object
Wymagane. Wartość Date, którą chcesz ocenić.
- DayOfWeek
- FirstDayOfWeek
Fakultatywny. Wartość wybrana z wyliczenia FirstDayOfWeek, która określa pierwszy dzień tygodnia. Jeśli nie zostanie określony, zostanie użyta Sunday.
- WeekOfYear
- FirstWeekOfYear
Fakultatywny. Wartość wybrana z wyliczenia FirstWeekOfYear, która określa pierwszy tydzień roku. Jeśli nie zostanie określony, zostanie użyta Jan1.
Zwraca
Wartość całkowita zawierająca określony składnik danej wartości Date.
Wyjątki
Interval jest nieprawidłowa.
DateValue nie jest coercible do Date.
Przykłady
Ten przykład przyjmuje datę i przy użyciu funkcji DatePart wyświetla kwartał roku, w którym występuje.
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)
Uwagi
Możesz użyć funkcji DatePart, aby ocenić wartość daty/godziny i zwrócić określony składnik. Na przykład możesz użyć DatePart do obliczenia dnia tygodnia lub bieżącej godziny.
Jeśli wybierzesz DateInterval.Weekday argumentu Interval, zwracana wartość jest zgodna z wartościami wyliczenia FirstDayOfWeek. Jeśli wybierzesz DateInterval.WeekOfYear, DatePart używa klas Calendar i CultureInfo przestrzeni nazw System.Globalization w celu określenia bieżących ustawień.
Argument FirstDayOfWeekValue ma wpływ na obliczenia korzystające z ustawień DateInterval.Weekday i DateInterval.WeekOfYearInterval. Argument FirstWeekOfYearValue ma wpływ na obliczenia, które określają DateInterval.WeekOfYear dla Interval.
Ponieważ każda wartość Date jest obsługiwana przez strukturę DateTime, jej metody zapewniają dodatkowe opcje pobierania części daty/godziny. Można na przykład uzyskać całą wartość daty zmiennej Date z wartością godziny ustawioną na północ w następujący sposób:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Argument Interval może mieć jedno z następujących ustawień.
| Wartość wyliczenia | Struna | Część wartości daty/godziny do zwrócenia |
|---|---|---|
DateInterval.Day |
d | Dzień miesiąca (od 1 do 31) |
DateInterval.DayOfYear |
y | Dzień roku (od 1 do 366) |
DateInterval.Hour |
h | Godzina |
DateInterval.Minute |
n | Minuta |
DateInterval.Month |
m | Miesiąc |
DateInterval.Quarter |
q | Ćwiartka |
DateInterval.Second |
s | Sekunda |
DateInterval.Weekday |
w | Dzień tygodnia (od 1 do 7) |
DateInterval.WeekOfYear |
Ww | Tydzień roku (od 1 do 53) |
DateInterval.Year |
yyyy | Rok |
Argument FirstDayOfWeekValue może mieć jedno z następujących ustawień.
| Wartość wyliczenia | Wartość | Opis |
|---|---|---|
FirstDayOfWeek.System |
0 | Pierwszy dzień tygodnia określony w ustawieniach systemowych |
FirstDayOfWeek.Sunday |
1 | Niedziela (wartość domyślna) |
FirstDayOfWeek.Monday |
2 | Poniedziałek (zgodny ze standardem ISO 8601, sekcja 3.17) |
FirstDayOfWeek.Tuesday |
3 | Wtorek |
FirstDayOfWeek.Wednesday |
4 | Środa |
FirstDayOfWeek.Thursday |
5 | Czwartek |
FirstDayOfWeek.Friday |
6 | Piątek |
FirstDayOfWeek.Saturday |
7 | Sobota |
Argument FirstWeekOfYearValue może mieć jedno z następujących ustawień.
| Wartość wyliczenia | Wartość | Opis |
|---|---|---|
FirstWeekOfYear.System |
0 | Pierwszy tydzień roku określony w ustawieniach systemowych |
FirstWeekOfYear.Jan1 |
1 | Tydzień, w którym występuje 1 stycznia (ustawienie domyślne) |
FirstWeekOfYear.FirstFourDays |
2 | Tydzień, który ma co najmniej cztery dni w nowym roku (zgodnie ze standardem ISO 8601, sekcja 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Pierwszy pełny tydzień w nowym roku |
Zobacz też
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- — podsumowanie typu danych (Visual Basic)