DatePart, functie

Geeft een variant (geheel getal) als resultaat die het opgegeven gedeelte van een bepaalde datum bevat.

Syntaxis

DatePart ( interval, datum [, eerstedagvanweek] [, eersteweekvanjaar] )

De syntaxis van de functie DatePart bevat deze argumenten:

Argument

Beschrijving

interval

Vereist. Een tekenreeksexpressie die het tijdsinterval aangeeft dat u als resultaat wilt geven.

datum

Vereist. Waarde van het type Variant (datum) die u wilt evalueren.

eerstedagvanweek

Optioneel. Een constante die de eerste dag van de week aangeeft. Als deze niet is opgegeven, wordt uitgegaan van zondag.

eersteweekvanjaar

Optioneel. Een constante die de eerste week van het jaar aangeeft. Als deze niet is opgegeven, wordt de week waarin 1 januari valt, als eerste week beschouwd.

Instellingen

Het intervalargument heeft de volgende instellingen:

Instelling

Beschrijving

jjjj

Jaar

k

Kwartaal

m

Maand

j

Dag van jaar

d

Dag

w

Weekdag

ww

Week

h

Uur

N

Minuut

s

Seconde

Het argument eerstedagvanweek heeft deze instellingen:

Constante

Waarde

Beschrijving

vbUseSystem

0

De NLS API-instelling gebruiken.

vbSunday

1

Zondag (standaard)

vbMonday

2

Maandag

vbTuesday

3

Dinsdag

vbWednesday

4

Woensdag

vbThursday

5

Donderdag

vbFriday

6

Vrijdag

vbSaturday

7

Zaterdag

Het argument eersteweekvanjaar heeft deze instellingen:

Constante

Waarde

Beschrijving

vbUseSystem

0

De NLS API-instelling gebruiken.

vbFirstJan1

1

Beginnen met de week waarin 1 januari valt (standaard).

vbFirstFourDays

2

Beginnen met de eerste week die minimaal vier dagen in het nieuwe jaar heeft.

vbFirstFullWeek

3

Beginnen met de eerste volledige week van het jaar.

Opmerkingen

U kunt de functie DatePart gebruiken om een datum te evalueren en een bepaald tijdsinterval te retourneren. Zo kunt u DatePart gebruiken om de dag van de week of het huidige uur te berekenen.

Het argument eerstedagvanweek is van invloed op berekeningen waarin de intervalsymbolen 'w' en 'ww' worden gebruikt.

Als datum een letterlijke datum is, wordt het opgegeven jaar een permanent onderdeel van die datum. Als datum echter tussen dubbele aanhalingstekens (" ") staat, en u het jaar weglaat, wordt het huidige jaar ingevoegd in de code wanneer de expressie met datum wordt geëvalueerd. Hierdoor kunt u code schrijven die in verschillende jaren kan worden gebruikt.

Opmerking: Als de eigenschap Calendar voor datum is ingesteld op Gregoriaans, moet de opgegeven datum de Gregoriaanse kalender volgen. Als de kalender Hijri is, moet de opgegeven datum de notatie van de Hijri kalender volgen.

Het geretourneerde datumonderdeel wordt uitgedrukt in de tijdseenheid van de huidige Arabische kalender. Als de huidige kalender bijvoorbeeld Hijri is en u het datumonderdeel jaar wilt retourneren, bestaat de jaarwaarde uit een Hijri-jaar.

Query voorbeelden

Expressie

Resultaten

Selecteer DatePart ("yyyy", [DateofSale]) AS NewDate FROM ProductSales;

Geeft als resultaat het jaar van de datumwaarden in het veld DateofSale.

Selecteer DatePart ("q", [DateofSale]) AS NewDate FROM ProductSales;

Geeft als resultaat het ' kwartaal ' (op basis van agenda jaar) van de datumwaarden van het veld ' DateofSale '.

Selecteer DatePart ("y", [DateofSale]) AS NewDate FROM ProductSales;

Geeft als resultaat de dag van het jaar (1 tot 365) van de datumwaarden van het veld DateofSale.

Selecteer DatePart ("d", [DateofSale]) AS NewDate FROM ProductSales;

Geeft als resultaat de dag van de datumwaarden in het veld DateofSale.

Selecteer DatePart ("w", [DateofSale]) AS NewDate FROM ProductSales;

Retourneert de ' Weekday ' (van 1 naar 7 waarbij 1 staat voor zondag) van de datumwaarden van het veld ' DateofSale '.

Selecteer DatePart ("ww", [DateofSale]) AS NewDate FROM ProductSales;

Geeft als resultaat het "week nummer" (van 1 tot 52) van de datumwaarden van het veld "DateofSale".

Selecteer DatePart ("m", [datum tijd]) AS NewDate FROM ProductSales;

Geeft als resultaat het uur van de datumwaarden van het veld DateTime.

Selecteer DatePart ("n", [datum tijd]) AS NewDate FROM ProductSales;

Geeft als resultaat de minuten van de datumwaarden van het veld DateTime.

Selecteer DatePart ("s", [datum tijd]) AS NewDate FROM ProductSales;

Hiermee wordt het aantal seconden geretourneerd van de datumwaarden van het veld DateTime.

Voorbeeld van VBA

Opmerking: In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Meer informatie over het werken met VBA vindt u door in de vervolgkeuzelijst naast Zoeken de optie Referentie voor ontwikkelaars te selecteren en een of meer termen in het zoekvenster te typen.

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

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Opmerking:  Deze pagina is automatisch vertaald en kan grammaticale fouten of onnauwkeurigheden bevatten. Wij hopen dat deze inhoud nuttig voor je is. Wil je ons laten weten of deze informatie nuttig is? Hier is het Engelstalige artikel ter referentie.

Uw Office-vaardigheden uitbreiden
Training verkennen
Als eerste nieuwe functies krijgen
Deelnemen aan Office Insiders

Was deze informatie nuttig?

Bedankt voor uw feedback.

Hartelijk dank voor uw feedback! Het lijkt ons een goed idee om u in contact te brengen met een van onze Office-ondersteuningsagenten.

×