DateAndTime.DatePart Metoda

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

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

Přetížení

Name	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Vrátí celočíselnou hodnotu obsahující zadanou komponentu dané `Date` hodnoty.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Vrátí hodnotu obsahující zadanou komponentu dané `Date` hodnoty.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Zdroj:: DateAndTime.vb

Zdroj:: DateAndTime.vb

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

Required. DateInterval Hodnota výčtu nebo řetězcový výraz představující část hodnoty data a času, kterou chcete vrátit.

DateValue: DateTime

Required. Hodnota Date , kterou chcete vyhodnotit.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Hodnota zvolená z výčtu FirstDayOfWeek , která určuje první den v týdnu. Pokud není zadáno, Sunday použije se.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Hodnota zvolená z výčtu FirstWeekOfYear , která určuje první týden v roce. Pokud není zadáno, Jan1 použije se.

Návraty

Int32

Celočíselná hodnota obsahující zadanou součást dané Date hodnoty.

Výjimky

ArgumentException

Interval není platný.

InvalidCastException

DateValue není vynucený na Date.

Příklady

Tento příklad používá 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 pomocí Calendar a CultureInfo tříd System.Globalization oboru názvů určíte aktuální nastavení.

Argument FirstDayOfWeekValue má vliv na výpočty, které používají nastaveníDateInterval.Weekday.DateInterval.WeekOfYearInterval Argument FirstWeekOfYearValue ovlivňuje výpočty, které určují DateInterval.WeekOfYear hodnotu Interval.

Vzhledem k tomu, že struktura podporuje Date každou DateTime hodnotu, poskytují její metody 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 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	String	Čá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	Čtvrtletí
`DateInterval.Second`	s	Second
`DateInterval.Weekday`	w	Den v týdnu (1 až 7)
`DateInterval.WeekOfYear`	Ww	Týden roku (1 až 53)
`DateInterval.Year`	yyyy	Rok

Argument FirstDayOfWeekValue může mít jedno z následujících nastavení.

Výčtová hodnota	Hodnota	Description
`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í.

Výčtová hodnota	Hodnota	Description
`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

Zdroj:: DateAndTime.vb

Zdroj:: DateAndTime.vb

Vrátí hodnotu obsahující zadanou komponentu 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