DateAndTime.DatePart Metódus

Definíció

Névtér:: Microsoft.VisualBasic

Szerelvény:: Microsoft.VisualBasic.Core.dll

Szerelvény:: Microsoft.VisualBasic.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy adott érték megadott összetevőjét tartalmazó egész számot ad Date vissza.

Túlterhelések

Name	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Egy adott érték megadott összetevőjét tartalmazó egész számot ad `Date` vissza.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Egy adott érték megadott összetevőjét tartalmazó értéket ad `Date` vissza.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Egy adott érték megadott összetevőjét tartalmazó egész számot ad Date vissza.

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

Paraméterek

Interval: DateInterval

Kötelező. Enumerálási DateInterval érték vagy sztringkifejezés, amely a visszaadni kívánt dátum/idő érték egy részét jelöli.

DateValue: DateTime

Kötelező. A Date kiértékelni kívánt érték.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Az enumerálásból FirstDayOfWeek kiválasztott érték, amely a hét első napját adja meg. Ha nincs megadva, Sunday lesz használva.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Az enumerálásból FirstWeekOfYear kiválasztott érték, amely az év első hetét határozza meg. Ha nincs megadva, Jan1 lesz használva.

Válaszok

Int32

Egy adott Date érték megadott összetevőjét tartalmazó egész szám.

Kivételek

ArgumentException

Interval érvénytelen.

InvalidCastException

DateValuenem kényszeríthető.Date

Példák

Ez a példa egy dátumot vesz igénybe, és a DatePart függvény használatával annak az évnek a negyedét jeleníti meg, amelyben bekövetkezik.

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)

Megjegyzések

A függvény segítségével DatePart kiértékelhet egy dátum/idő értéket, és visszaadhat egy adott összetevőt. Használhatja például DatePart a hét napját vagy az aktuális órát.

Ha az DateInterval.Weekday argumentumot választjaInterval, a visszaadott érték összhangban van az FirstDayOfWeek enumerálás értékeivel. Ha ezt választja DateInterval.WeekOfYear, DatePart a Calendar névtér és CultureInfo az System.Globalization osztályok használatával határozza meg az aktuális beállításokat.

Az FirstDayOfWeekValue argumentum hatással van azokat a számításokat, amelyek a beállításokat és DateInterval.WeekdayDateInterval.WeekOfYear a Interval beállításokat használják. Az FirstWeekOfYearValue argumentum hatással van a DateInterval.WeekOfYear megadott számításokra Interval.

Mivel egy struktúra minden Date értéket támogat DateTime , a metódusok további lehetőségeket biztosítanak a dátum-/időrészek lekéréséhez. Beolvashatja például egy Date változó teljes dátumértékét, és az időérték éjfélre van állítva az alábbiak szerint:

Dim CurrDatTim As Date = Now   ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.

Az Interval argumentum az alábbi beállítások egyikével rendelkezhet.

Számbavételi érték	Lánc	A visszaadandó dátum/idő érték egy része
`DateInterval.Day`	d	Hónap napja (1–31)
`DateInterval.DayOfYear`	y	Az év napja (1–366)
`DateInterval.Hour`	h	Óra
`DateInterval.Minute`	n	Minute
`DateInterval.Month`	m	Hónap
`DateInterval.Quarter`	q	Negyed
`DateInterval.Second`	s	Second
`DateInterval.Weekday`	w	A hét napja (1–7)
`DateInterval.WeekOfYear`	Ww	Év hetében (1–53)
`DateInterval.Year`	yyyy	Year

Az FirstDayOfWeekValue argumentum az alábbi beállítások egyikével rendelkezhet.

Számbavételi érték	Érték	Leírás
`FirstDayOfWeek.System`	0	A rendszerbeállításokban megadott hét első napja
`FirstDayOfWeek.Sunday`	1	Vasárnap (alapértelmezett)
`FirstDayOfWeek.Monday`	2	Hétfő (megfelel az ISO 8601 szabványnak, 3.17. szakasz)
`FirstDayOfWeek.Tuesday`	3	Tuesday
`FirstDayOfWeek.Wednesday`	4	Szerda
`FirstDayOfWeek.Thursday`	5	Csütörtök
`FirstDayOfWeek.Friday`	6	Péntek
`FirstDayOfWeek.Saturday`	7	Szombat

Az FirstWeekOfYearValue argumentum az alábbi beállítások egyikével rendelkezhet.

Számbavételi érték	Érték	Leírás
`FirstWeekOfYear.System`	0	A rendszerbeállításokban megadott év első hete
`FirstWeekOfYear.Jan1`	1	A január 1-jei hét (alapértelmezett)
`FirstWeekOfYear.FirstFourDays`	2	Az új évben legalább négy nappal rendelkező hét (megfelel az ISO 8601 szabvány 3.17. szakaszának)
`FirstWeekOfYear.FirstFullWeek`	3	Új év első teljes hete

Lásd még

A következőre érvényes:

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Egy adott érték megadott összetevőjét tartalmazó értéket ad Date vissza.

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