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 -> 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. 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.WeekOfYear
Interval
. 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 -> 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. 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.WeekOfYear
Interval
. 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
https://aka.ms/ContentUserFeedback.
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ź:Prześlij i wyświetl opinię dla