DateAndTime.DatePart Metoda

Definice

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 Date.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Vrátí hodnotu obsahující zadanou komponentu dané hodnoty Date.

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 -> 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

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é

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 -> 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

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é

Platí pro