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 -> 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
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.WeekOfYear
Interval
. 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 -> 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
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.WeekOfYear
DatePart
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.WeekOfYear
Interval
. 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
https://aka.ms/ContentUserFeedback.
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:Odeslat a zobrazit názory pro