DateAndTime.DatePart Methode

Definitie

Naamruimte:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert een geheel getal dat het opgegeven onderdeel van een bepaalde Date waarde bevat.

Overloads

Name	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Retourneert een geheel getal dat het opgegeven onderdeel van een bepaalde `Date` waarde bevat.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Retourneert een waarde die het opgegeven onderdeel van een bepaalde `Date` waarde bevat.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Retourneert een geheel getal dat het opgegeven onderdeel van een bepaalde Date waarde bevat.

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

Parameters

Interval: DateInterval

Required. Een DateInterval opsommingswaarde of een tekenreeksexpressie die het deel van de datum/tijd-waarde vertegenwoordigt die u wilt retourneren.

DateValue: DateTime

Required. De Date waarde die u wilt evalueren.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Een waarde die is gekozen uit de FirstDayOfWeek opsomming die de eerste dag van de week aangeeft. Als dit niet is opgegeven, wordt Sunday gebruikt.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Een waarde die is gekozen uit de FirstWeekOfYear opsomming die de eerste week van het jaar aangeeft. Als dit niet is opgegeven, wordt Jan1 gebruikt.

Retouren

Int32

Een geheel getal dat het opgegeven onderdeel van een bepaalde Date waarde bevat.

Uitzonderingen

ArgumentException

Interval is ongeldig.

InvalidCastException

DateValue is niet coercible aan Date.

Voorbeelden

In dit voorbeeld wordt een datum gebruikt en met behulp van de DatePart functie wordt het kwartaal van het jaar weergegeven waarin deze plaatsvindt.

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)

Opmerkingen

U kunt de DatePart functie gebruiken om een datum/tijd-waarde te evalueren en een specifiek onderdeel te retourneren. U kunt bijvoorbeeld de dag van de week of het huidige uur berekenen DatePart .

Als u voor het argument kiestDateInterval.Weekday, is de geretourneerde waarde consistent met de waarden van de FirstDayOfWeek opsomming.Interval Als u kiest DateInterval.WeekOfYear, DatePart gebruikt u de Calendar en CultureInfo klassen van de System.Globalization naamruimte om uw huidige instellingen te bepalen.

Het FirstDayOfWeekValue argument is van invloed op berekeningen die gebruikmaken van de DateInterval.Weekday en DateInterval.WeekOfYearInterval instellingen. Het FirstWeekOfYearValue argument is van invloed op berekeningen die zijn opgegeven DateInterval.WeekOfYear voor Interval.

Omdat elke Date waarde wordt ondersteund door een DateTime structuur, bieden de methoden u extra opties voor het ophalen van datum-/tijdonderdelen. U kunt bijvoorbeeld de volledige datumwaarde van een Date variabele verkrijgen, waarbij de tijdwaarde is ingesteld op middernacht, als volgt:

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

Het Interval argument kan een van de volgende instellingen hebben.

Opsommingswaarde	String	Deel van de datum/tijd-waarde die moet worden geretourneerd
`DateInterval.Day`	d	Dag van de maand (1 tot en met 31)
`DateInterval.DayOfYear`	y	Dag van het jaar (1 tot en met 366)
`DateInterval.Hour`	h	Uur
`DateInterval.Minute`	n	Minuut
`DateInterval.Month`	m	Month
`DateInterval.Quarter`	q	Kwartaal
`DateInterval.Second`	s	Tweede
`DateInterval.Weekday`	w	Dag van de week (1 tot en met 7)
`DateInterval.WeekOfYear`	ww	Week van het jaar (1 tot en met 53)
`DateInterval.Year`	yyyy	Jaar

Het FirstDayOfWeekValue argument kan een van de volgende instellingen hebben.

Opsommingswaarde	Value	Description
`FirstDayOfWeek.System`	0	Eerste dag van de week die is opgegeven in systeeminstellingen
`FirstDayOfWeek.Sunday`	1	Zondag (standaard)
`FirstDayOfWeek.Monday`	2	Maandag (voldoet aan ISO-norm 8601, sectie 3.17)
`FirstDayOfWeek.Tuesday`	3	Tuesday
`FirstDayOfWeek.Wednesday`	4	Woensdag
`FirstDayOfWeek.Thursday`	5	donderdag
`FirstDayOfWeek.Friday`	6	Vrijdag
`FirstDayOfWeek.Saturday`	7	Zaterdag

Het FirstWeekOfYearValue argument kan een van de volgende instellingen hebben.

Opsommingswaarde	Value	Description
`FirstWeekOfYear.System`	0	Eerste week van het jaar opgegeven in systeeminstellingen
`FirstWeekOfYear.Jan1`	1	Week waarin 1 januari plaatsvindt (standaard)
`FirstWeekOfYear.FirstFourDays`	2	Week met ten minste vier dagen in het nieuwe jaar (voldoet aan ISO-norm 8601, sectie 3.17)
`FirstWeekOfYear.FirstFullWeek`	3	Eerste volledige week in nieuw jaar

Zie ook

Van toepassing op

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Retourneert een waarde die het opgegeven onderdeel van een bepaalde Date waarde bevat.

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