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 komponentu dané hodnoty Date.
Přetížení
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Vrátí celočíselnou hodnotu obsahující zadanou komponentu dané hodnoty |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Vrátí hodnotu obsahující zadanou komponentu dané hodnoty |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Zdroj:
- DateAndTime.vb
- Zdroj:
- DateAndTime.vb
- Zdroj:
- DateAndTime.vb
Vrátí celočíselnou hodnotu obsahující zadanou komponentu dané hodnoty 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 -> 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
Požadovaný. Hodnota výčtu DateInterval nebo řetězcový výraz představující část hodnoty data a času, kterou chcete vrátit.
- DateValue
- DateTime
Požadovaný. Hodnota Date, kterou chcete vyhodnotit.
- FirstDayOfWeekValue
- FirstDayOfWeek
Volitelný. Hodnota zvolená z FirstDayOfWeek výčtu, která určuje první den v týdnu. Pokud není zadaný, použije se Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Volitelný. Hodnota zvolená z FirstWeekOfYear výčtu, která určuje první týden roku. Pokud není zadaný, použije se Jan1.
Návraty
Celočíselná hodnota obsahující zadanou komponentu dané hodnoty Date.
Výjimky
Interval není platný.
DateValue není vynucené Date.
Příklady
Tento příklad používá datum a pomocí funkce DatePart zobrazí čtvrtletí roku, ve kterém se vyskytuje.
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 DatePart můžete 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 pro argument Interval zvolíte DateInterval.Weekday, vrácená hodnota je konzistentní s hodnotami FirstDayOfWeek výčtu. Pokud zvolíte DateInterval.WeekOfYear, DatePart použije Calendar a CultureInfo třídy oboru názvů System.Globalization k určení aktuálního nastavení.
Argument FirstDayOfWeekValue ovlivňuje výpočty, které používají nastavení DateInterval.Weekday 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, poskytují její metody další možnosti při načítání částí data a času. Můžete například získat celou hodnotu data Date proměnné s hodnotou času nastavenou na půlnoc 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í.
| Hodnota výčtu | Ř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 | Měsíc |
DateInterval.Quarter |
q | Čtvrt |
DateInterval.Second |
s | Vteřina |
DateInterval.Weekday |
w | Den v týdnu (1 až 7) |
DateInterval.WeekOfYear |
Ww | Týden roku (1 až 53) |
DateInterval.Year |
yyyyy | Rok |
Argument FirstDayOfWeekValue může mít jedno z následujících nastavení.
| Hodnota výčtu | Hodnota | Popis |
|---|---|---|
FirstDayOfWeek.System |
0 | První den týdne zadaný v nastavení systému |
FirstDayOfWeek.Sunday |
1 | Neděle (výchozí) |
FirstDayOfWeek.Monday |
2 | Pondělí (v souladu se standardem ISO 8601, oddílem 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í.
| Hodnota výčtu | Hodnota | Popis |
|---|---|---|
FirstWeekOfYear.System |
0 | První týden roku zadaný v nastavení systému |
FirstWeekOfYear.Jan1 |
1 | Týden, ve kterém nastane 1. leden (výchozí) |
FirstWeekOfYear.FirstFourDays |
2 | Týden, který má alespoň čtyři dny v novém roce (vyhovuje normě 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 komponentu dané hodnoty 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 -> 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
Požadovaný. Hodnota výčtu DateInterval nebo řetězcový výraz představující část hodnoty data a času, kterou chcete vrátit.
- DateValue
- Object
Požadovaný. Hodnota Date, kterou chcete vyhodnotit.
- DayOfWeek
- FirstDayOfWeek
Volitelný. Hodnota zvolená z FirstDayOfWeek výčtu, která určuje první den v týdnu. Pokud není zadaný, použije se Sunday.
- WeekOfYear
- FirstWeekOfYear
Volitelný. Hodnota zvolená z FirstWeekOfYear výčtu, která určuje první týden roku. Pokud není zadaný, použije se Jan1.
Návraty
Celočíselná hodnota obsahující zadanou komponentu dané hodnoty Date.
Výjimky
Interval je neplatný.
DateValue není vynucené Date.
Příklady
Tento příklad používá datum a pomocí funkce DatePart zobrazí čtvrtletí roku, ve kterém se vyskytuje.
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 DatePart můžete 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 pro argument Interval zvolíte DateInterval.Weekday, vrácená hodnota je konzistentní s hodnotami FirstDayOfWeek výčtu. Pokud zvolíte DateInterval.WeekOfYear, DatePart použije Calendar a CultureInfo třídy oboru názvů System.Globalization k určení aktuálního nastavení.
Argument FirstDayOfWeekValue ovlivňuje výpočty, které používají nastavení DateInterval.Weekday 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, poskytují její metody další možnosti při načítání částí data a času. Můžete například získat celou hodnotu data Date proměnné s hodnotou času nastavenou na půlnoc 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í.
| Hodnota výčtu | Ř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 | Měsíc |
DateInterval.Quarter |
q | Čtvrt |
DateInterval.Second |
s | Vteřina |
DateInterval.Weekday |
w | Den v týdnu (1 až 7) |
DateInterval.WeekOfYear |
Ww | Týden roku (1 až 53) |
DateInterval.Year |
yyyyy | Rok |
Argument FirstDayOfWeekValue může mít jedno z následujících nastavení.
| Hodnota výčtu | Hodnota | Popis |
|---|---|---|
FirstDayOfWeek.System |
0 | První den týdne zadaný v nastavení systému |
FirstDayOfWeek.Sunday |
1 | Neděle (výchozí) |
FirstDayOfWeek.Monday |
2 | Pondělí (v souladu se standardem ISO 8601, oddílem 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í.
| Hodnota výčtu | Hodnota | Popis |
|---|---|---|
FirstWeekOfYear.System |
0 | První týden roku zadaný v nastavení systému |
FirstWeekOfYear.Jan1 |
1 | Týden, ve kterém nastane 1. leden (výchozí) |
FirstWeekOfYear.FirstFourDays |
2 | Týden, který má alespoň čtyři dny v novém roce (vyhovuje normě 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)
