DateAndTime.DatePart Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí celočíselnou hodnotu obsahující zadanou součást dané Date hodnoty.
Přetížení
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Vrátí celočíselnou hodnotu obsahující zadanou komponentu dané |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Vrátí hodnotu obsahující zadanou součást dané |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Zdroj:
- DateAndTime.vb
- Zdroj:
- DateAndTime.vb
- Zdroj:
- DateAndTime.vb
Vrátí celočíselnou hodnotu obsahující zadanou komponentu dané Date hodnoty.
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
Povinná hodnota. Hodnota DateInterval výčtu nebo řetězcový výraz představující část hodnoty data a času, kterou chcete vrátit.
- DateValue
- DateTime
Povinná hodnota. Hodnota Date , kterou chcete vyhodnotit.
- FirstDayOfWeekValue
- FirstDayOfWeek
Nepovinný parametr. Hodnota vybraná z výčtu FirstDayOfWeek , která určuje první den v týdnu. Pokud není zadán, Sunday použije se.
- FirstWeekOfYearValue
- FirstWeekOfYear
Nepovinný parametr. Hodnota vybraná z výčtu FirstWeekOfYear , která určuje první týden v roce. Pokud není zadán, Jan1 použije se.
Návraty
Celočíselná hodnota obsahující zadanou součást dané Date hodnoty.
Výjimky
Interval není platný.
DateValue není vynutitelný k Date.
Příklady
Tento příklad vezme datum a pomocí DatePart funkce zobrazí čtvrtletí roku, ve kterém k němu dochází.
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)
Poznámky
Funkci můžete použít DatePart k vyhodnocení hodnoty data a času a vrácení konkrétní komponenty. Můžete například použít DatePart k výpočtu dne v týdnu nebo aktuální hodiny.
Pokud zvolíte DateInterval.Weekday argument Interval , vrácená hodnota je konzistentní s hodnotami výčtu FirstDayOfWeek . Pokud zvolíte DateInterval.WeekOfYear, DatePart použije Calendar třídy a CultureInfo oboru názvů k určení aktuálního System.Globalization nastavení.
Argument FirstDayOfWeekValue má vliv na výpočty, které používají DateInterval.Weekday nastavení a DateInterval.WeekOfYearInterval . Argument FirstWeekOfYearValue ovlivňuje výpočty, které určují DateInterval.WeekOfYear pro Interval.
Vzhledem k tomu, že každá Date hodnota je podporována strukturou DateTime , její metody poskytují další možnosti při načítání částí data a času. Můžete například získat celou hodnotu data proměnné s časovou hodnotou nastavenou Date na půlnoc, a to následujícím způsobem:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Argument Interval může mít jedno z následujících nastavení.
| Výčtová hodnota | Řetězec | Část hodnoty data a času, která se má vrátit |
|---|---|---|
DateInterval.Day |
d | Den v měsíci (1 až 31) |
DateInterval.DayOfYear |
y | Den v roce (1 až 366) |
DateInterval.Hour |
h | Hodina |
DateInterval.Minute |
n | Minuta |
DateInterval.Month |
m | Month (Měsíc) |
DateInterval.Quarter |
q | Quarter (Čtvrtletí) |
DateInterval.Second |
s | Second |
DateInterval.Weekday |
w | Den v týdnu (1 až 7) |
DateInterval.WeekOfYear |
ww | Týden v roce (1 až 53) |
DateInterval.Year |
rrrr | Year (Rok) |
Argument FirstDayOfWeekValue může mít jedno z následujících nastavení.
| Výčtová hodnota | Hodnota | Popis |
|---|---|---|
FirstDayOfWeek.System |
0 | První den týdne určený v systémových nastaveních. |
FirstDayOfWeek.Sunday |
1 | Neděle (výchozí) |
FirstDayOfWeek.Monday |
2 | Pondělí (v souladu se standardem ISO 8601, oddíl 3.17) |
FirstDayOfWeek.Tuesday |
3 | Úterý |
FirstDayOfWeek.Wednesday |
4 | Středa |
FirstDayOfWeek.Thursday |
5 | Čtvrtek |
FirstDayOfWeek.Friday |
6 | Pátek |
FirstDayOfWeek.Saturday |
7 | Sobota |
Argument FirstWeekOfYearValue může mít jedno z následujících nastavení.
| Výčtová hodnota | Hodnota | Popis |
|---|---|---|
FirstWeekOfYear.System |
0 | První týden v roce určený v systémových nastaveních |
FirstWeekOfYear.Jan1 |
1 | Týden do kterého spadá datum 1. ledna (výchozí) |
FirstWeekOfYear.FirstFourDays |
2 | Týden, který obsahuje alespoň čtyři dny nového roku (v souladu se standardem ISO 8601, oddíl 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | První celý týden v novém roce |
Viz také
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Souhrn datových typů (Visual Basic)
Platí pro
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Zdroj:
- DateAndTime.vb
- Zdroj:
- DateAndTime.vb
- Zdroj:
- DateAndTime.vb
Vrátí hodnotu obsahující zadanou součást dané Date hodnoty.
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
Povinná hodnota. Hodnota DateInterval výčtu nebo řetězcový výraz představující část hodnoty data a času, kterou chcete vrátit.
- DateValue
- Object
Povinná hodnota. Hodnota Date , kterou chcete vyhodnotit.
- DayOfWeek
- FirstDayOfWeek
Nepovinný parametr. Hodnota vybraná z výčtu FirstDayOfWeek , která určuje první den v týdnu. Pokud není zadán, Sunday použije se.
- WeekOfYear
- FirstWeekOfYear
Nepovinný parametr. Hodnota vybraná z výčtu FirstWeekOfYear , která určuje první týden v roce. Pokud není zadán, Jan1 použije se.
Návraty
Celočíselná hodnota obsahující zadanou součást dané Date hodnoty.
Výjimky
Formát Interval je neplatný.
DateValue není vynutitelný k Date.
Příklady
Tento příklad vezme datum a pomocí DatePart funkce zobrazí čtvrtletí roku, ve kterém k němu dochází.
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)
Poznámky
Pomocí funkce můžete DatePart vyhodnotit hodnotu data a času a vrátit konkrétní komponentu. Můžete například použít DatePart k výpočtu dne v týdnu nebo aktuální hodiny.
Pokud zvolíte DateInterval.Weekday argument Interval , vrácená hodnota je konzistentní s hodnotami výčtu FirstDayOfWeek . Pokud zvolíte , DateInterval.WeekOfYearDatePart použije Calendar třídy a CultureInfo oboru názvů k určení aktuálního System.Globalization nastavení.
Argument FirstDayOfWeekValue ovlivňuje výpočty, které používají DateInterval.Weekday nastavení a DateInterval.WeekOfYearInterval . Argument FirstWeekOfYearValue ovlivňuje výpočty, které určují DateInterval.WeekOfYear pro Interval.
Vzhledem k tomu, že každá Date hodnota je podporována strukturou DateTime , její metody poskytují další možnosti při načítání částí data a času. Můžete například získat celou hodnotu data proměnné s hodnotou času nastavenou Date na půlnoc, a to následujícím způsobem:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Argument Interval může mít jedno z následujících nastavení.
| Výčtová hodnota | Řetězec | Část hodnoty data a času, která se má vrátit |
|---|---|---|
DateInterval.Day |
d | Den v měsíci (1 až 31) |
DateInterval.DayOfYear |
y | Den roku (1 až 366) |
DateInterval.Hour |
h | Hodina |
DateInterval.Minute |
n | Minuta |
DateInterval.Month |
m | Month (Měsíc) |
DateInterval.Quarter |
q | Quarter (Čtvrtletí) |
DateInterval.Second |
s | Second |
DateInterval.Weekday |
w | Den v týdnu (1 až 7) |
DateInterval.WeekOfYear |
ww | Týden v roce (1 až 53) |
DateInterval.Year |
rrrr | Year (Rok) |
Argument FirstDayOfWeekValue může mít jedno z následujících nastavení.
| Výčtová hodnota | Hodnota | Popis |
|---|---|---|
FirstDayOfWeek.System |
0 | První den týdne určený v systémových nastaveních. |
FirstDayOfWeek.Sunday |
1 | Neděle (výchozí) |
FirstDayOfWeek.Monday |
2 | Pondělí (v souladu se standardem ISO 8601, oddíl 3.17) |
FirstDayOfWeek.Tuesday |
3 | Úterý |
FirstDayOfWeek.Wednesday |
4 | Středa |
FirstDayOfWeek.Thursday |
5 | Čtvrtek |
FirstDayOfWeek.Friday |
6 | Pátek |
FirstDayOfWeek.Saturday |
7 | Sobota |
Argument FirstWeekOfYearValue může mít jedno z následujících nastavení.
| Výčtová hodnota | Hodnota | Popis |
|---|---|---|
FirstWeekOfYear.System |
0 | První týden v roce určený v systémových nastaveních |
FirstWeekOfYear.Jan1 |
1 | Týden do kterého spadá datum 1. ledna (výchozí) |
FirstWeekOfYear.FirstFourDays |
2 | Týden, který obsahuje alespoň čtyři dny nového roku (v souladu se standardem ISO 8601, oddíl 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | První celý týden v novém roce |
Viz také
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Souhrn datových typů (Visual Basic)
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro