DatePart, functie
Van toepassing op
Geeft een variant (geheel getal) als resultaat die het opgegeven gedeelte van een bepaalde datum bevat.
| Waarschuwing Er is een probleem met het gebruik van deze functie. De laatste maandag in sommige kalenderjaren kan worden geretourneerd als week 53 wanneer deze week 1 moet zijn. Zie Format or DatePart functions can return wrong week number for last monday in Year (De functies Format or DatePart can return wrong week number for last monday in Year) voor meer informatie en een tijdelijke oplossing. |
|---|
Syntaxis
DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )
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 deze 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 firstdayofweek 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 firstdayofweek is van invloed op berekeningen die gebruikmaken van de intervalsymbolen 'w' en 'ww'.
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.
Queryvoorbeelden
| Expression | Resultaten |
|---|---|
| SELECT DatePart("yyyyy",[DateofSale]) AS NewDate FROM ProductVerkoop; | Retourneert het 'Jaar' van de datumwaarden van het veld 'DateofSale'. |
| SELECT DatePart("q";[DateofSale]) AS NewDate FROM ProductVerkoop; | Retourneert het kwartaal (op basis van het kalenderjaar) van de datumwaarden van het veld 'DateofSale'. |
| SELECT DatePart("y";[DateofSale]) AS NewDate FROM ProductVerkoop; | Retourneert de 'Day of Year' (1 tot en met 365) van de datumwaarden van het veld 'DateofSale'. |
| SELECT DatePart("d";[DateofSale]) AS NewDate FROM ProductVerkoop; | Retourneert de 'Dag' van de datumwaarden van het veld 'DateofSale'. |
| SELECT DatePart("w";[DateofSale]) AS NewDate FROM ProductVerkoop; | Retourneert de 'Weekdag' (van 1 tot 7 waarbij 1 staat voor zondag) van de datumwaarden van het veld 'DateofSale'. |
| SELECT DatePart("ww";[DateofSale]) AS NewDate FROM ProductVerkoop; | Retourneert het weeknummer (van 1 tot 52) van de datumwaarden van het veld 'DateofSale'. |
| SELECT DatePart("h";[DateTime]) AS NewDate FROM ProductVerkoop; | Retourneert het 'Uur' van de datumwaarden van het veld 'DateTime'. |
| SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductVerkoop; | Retourneert de 'Minuten' van de datumwaarden van het veld 'DateTime'. |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductVerkoop; | Retourneert de 'seconden' van de datumwaarden van het veld 'DateTime'. |
VBA-voorbeeld
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