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 Date wartości.
Przeciążenia
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Zwraca wartość całkowitą zawierającą określony składnik danej |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Zwraca wartość zawierającą określony składnik danej |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Ź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 Date wartości.
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 -> intPublic 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 IntegerParametry
- Interval
- DateInterval
Wymagane. DateInterval Wartość wyliczenia lub wyrażenie ciągu reprezentujące część wartości daty/godziny, którą chcesz zwrócić.
- DateValue
- DateTime
Wymagane. Date Wartość, którą chcesz ocenić.
- FirstDayOfWeekValue
- FirstDayOfWeek
Opcjonalny. Wartość wybrana z FirstDayOfWeek wyliczenia, która określa pierwszy dzień tygodnia. Jeśli nie zostanie określony, Sunday zostanie użyty.
- FirstWeekOfYearValue
- FirstWeekOfYear
Opcjonalny. Wartość wybrana z FirstWeekOfYear wyliczenia, która określa pierwszy tydzień roku. Jeśli nie zostanie określony, Jan1 zostanie użyty.
Zwraca
Wartość całkowita zawierająca określony składnik danej Date wartości.
Wyjątki
Interval jest nieprawidłowy.
DateValue nie jest coercible do Date.
Przykłady
Ten przykład przyjmuje datę i przy użyciu DatePart funkcji 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ć DatePart funkcji , aby ocenić wartość daty/godziny i zwrócić określony składnik. Możesz na przykład użyć DatePart polecenia , aby obliczyć dzień tygodnia lub bieżącą godzinę.
W przypadku wybrania DateInterval.Weekday argumentu Interval zwrócona wartość jest zgodna z wartościami FirstDayOfWeek wyliczenia. Jeśli wybierzesz opcję DateInterval.WeekOfYear, DatePart użyje Calendar klas System.Globalization i CultureInfo przestrzeni nazw do określenia bieżących ustawień.
Argument FirstDayOfWeekValue ma wpływ na obliczenia, które używają DateInterval.Weekday ustawień i DateInterval.WeekOfYearInterval . Argument FirstWeekOfYearValue ma wpływ na obliczenia, które określają DateInterval.WeekOfYear wartość .Interval
Ponieważ każda Date wartość jest obsługiwana DateTime przez strukturę, 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 | Ciąg | 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 | Month (Miesiąc) |
DateInterval.Quarter |
q | Quarter (Kwartał) |
DateInterval.Second |
s | Second |
DateInterval.Weekday |
w | Dzień tygodnia (od 1 do 7) |
DateInterval.WeekOfYear |
ww | Tydzień roku (od 1 do 53) |
DateInterval.Year |
yyyy | Year (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 (domyślnie) |
FirstDayOfWeek.Monday |
2 | Poniedziałek (zgodne ze standardem ISO 8601, pkt. 3.17) |
FirstDayOfWeek.Tuesday |
3 | Tuesday |
FirstDayOfWeek.Wednesday |
4 | Środa |
FirstDayOfWeek.Thursday |
5 | Thursday |
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ń zawierający dzień 1 stycznia (domyślnie) |
FirstWeekOfYear.FirstFourDays |
2 | Tydzień, który ma co najmniej cztery dni w nowym roku (zgodnie ze standardem ISO 8601, pkt. 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
- Typ danych — Podsumowanie (Visual Basic)
Dotyczy
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
- Źródło:
- DateAndTime.vb
Zwraca wartość zawierającą określony składnik danej Date wartości.
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 -> intPublic 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 IntegerParametry
- Interval
- String
Wymagane. DateInterval Wartość wyliczenia lub wyrażenie ciągu reprezentujące część wartości daty/godziny, którą chcesz zwrócić.
- DateValue
- Object
Wymagane. Date Wartość, którą chcesz oszacować.
- DayOfWeek
- FirstDayOfWeek
Opcjonalny. Wartość wybrana z FirstDayOfWeek wyliczenia, która określa pierwszy dzień tygodnia. Jeśli nie zostanie określony, Sunday zostanie użyty.
- WeekOfYear
- FirstWeekOfYear
Opcjonalny. Wartość wybrana z FirstWeekOfYear wyliczenia, która określa pierwszy tydzień roku. Jeśli nie zostanie określony, Jan1 zostanie użyty.
Zwraca
Wartość całkowita zawierająca określony składnik danej Date wartości.
Wyjątki
Nazwa Interval jest niepoprawna.
DateValue nie jest coercible do Date.
Przykłady
Ten przykład przyjmuje datę i przy użyciu DatePart funkcji 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ć DatePart funkcji , aby ocenić wartość daty/godziny i zwrócić określony składnik. Możesz na przykład użyć DatePart polecenia , aby obliczyć dzień tygodnia lub bieżącą godzinę.
W przypadku wybrania DateInterval.Weekday argumentu Interval zwrócona wartość jest zgodna z wartościami FirstDayOfWeek wyliczenia. Jeśli wybierzesz opcję DateInterval.WeekOfYear, DatePart użyje Calendar klas System.Globalization i CultureInfo przestrzeni nazw do określenia bieżących ustawień.
Argument FirstDayOfWeekValue ma wpływ na obliczenia, które używają DateInterval.Weekday ustawień i DateInterval.WeekOfYearInterval . Argument FirstWeekOfYearValue ma wpływ na obliczenia, które określają DateInterval.WeekOfYear wartość .Interval
Ponieważ każda Date wartość jest obsługiwana DateTime przez strukturę, 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 | Ciąg | 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 | Month (Miesiąc) |
DateInterval.Quarter |
q | Quarter (Kwartał) |
DateInterval.Second |
s | Second |
DateInterval.Weekday |
w | Dzień tygodnia (od 1 do 7) |
DateInterval.WeekOfYear |
ww | Tydzień roku (od 1 do 53) |
DateInterval.Year |
yyyy | Year (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 (domyślnie) |
FirstDayOfWeek.Monday |
2 | Poniedziałek (zgodne ze standardem ISO 8601, pkt. 3.17) |
FirstDayOfWeek.Tuesday |
3 | Tuesday |
FirstDayOfWeek.Wednesday |
4 | Środa |
FirstDayOfWeek.Thursday |
5 | Thursday |
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ń zawierający dzień 1 stycznia (domyślnie) |
FirstWeekOfYear.FirstFourDays |
2 | Tydzień, który ma co najmniej cztery dni w nowym roku (zgodnie ze standardem ISO 8601, pkt. 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
- Typ danych — Podsumowanie (Visual Basic)
Dotyczy
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla