Returnerer en variant (heltall) som inneholder den angitte delen av en gitt dato.
Advarsel! Det er et problem med bruken av denne funksjonen. Den siste mandagen i noen kalenderår kan returneres som uke 53 når det skal være uke 1. Hvis du vil ha mer informasjon og en løsning, kan du se Format- eller DatePart-funksjoner som kan returnere feil ukenummer for forrige mandag i år. |
Syntaks
DatePart ( intervall; dato [, første dag i uken] [, første uke i året] )
Syntaksen for funksjonen DatePart har følgende argumenter:
Argument |
Beskrivelse |
intervall |
Obligatorisk. Strenguttrykk som er tidsintervallet du vil returnere. |
date |
Obligatorisk. Variantverdi (dato) som du vil evaluere. |
første dag i uken |
Valgfritt. En konstant som angir første dag i uken. Hvis den ikke er angitt, brukes søndag. |
første uke i året |
Valgfritt. En konstant som angir den første uken i året. Hvis den ikke er angitt, antas den første uken å være uken der 1. januar forekommer. |
Innstillinger
Intervallargumentet har disse innstillingene:
Innstilling |
Beskrivelse |
åååå |
År |
q |
Kvartal |
m |
Måned |
y |
Dag i året |
d |
Dag |
w |
Weekday |
ww |
Uke |
t |
Time |
n |
Minutt |
s |
Sekund |
Argumentet første dag i uken har disse innstillingene:
Konstant |
Value |
Beskrivelse |
vbUseSystem |
0 |
Bruk NLS API-innstillingen. |
Vbsunday |
1 |
Søndag (standard) |
Vbmonday |
2 |
Mandag |
vbTuesday |
3 |
Tirsdag |
vbWednesday |
4 |
Onsdag |
vbThursday |
5 |
Torsdag |
vbFriday |
6 |
Fredag |
vbSaturday |
7 |
Lørdag |
Argumentet for første uke i året har disse innstillingene:
Konstant |
Value |
Beskrivelse |
vbUseSystem |
0 |
Bruk NLS API-innstillingen. |
vbFirstJan1 |
1 |
Start med uken der 1. januar forekommer (standard). |
vbFirstFourDays |
2 |
Start med den første uken som har minst fire dager i det nye året. |
vbFirstFullWeek |
3 |
Start med første hele uke i året. |
Merknader
Du kan bruke DatePart-funksjonen til å evaluere en dato og returnere et bestemt tidsintervall. Du kan for eksempel bruke DatePart til å beregne ukedagen eller gjeldende time.
Argumentet firstdayofweek påvirker beregninger som bruker intervallsymbolene «w» og «ww».
Hvis date er en datolitteral, blir det angitte året en permanent del av denne datoen. Hvis dato imidlertid er omsluttet av doble anførselstegn (" "), og du utelater året, settes gjeldende år inn i koden hver gang datouttrykket evalueres. Dette gjør det mulig å skrive kode som kan brukes i forskjellige år.
Obs!: For dato, hvis innstillingen for kalenderegenskapen er gregoriansk, må den angitte datoen være gregoriansk. Hvis kalenderen er Hijri, må den angitte datoen være Hijri.
Den returnerte datodelen er i tidsperiodeenhetene i den gjeldende arabiske kalenderen. Hvis den gjeldende kalenderen for eksempel er Hijri og datodelen som skal returneres, er årets verdi et Hijri-år.
Spørringseksempler
Expression |
Resultater |
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer «Året» for datoverdiene i feltet «DateofSale». |
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer Kvartalet (basert på kalenderår) for datoverdiene i feltet DateofSale. |
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer dagen i året (1 til 365) for datoverdiene i feltet DateofSale. |
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer "Day" for datoverdiene i feltet "DateofSale". |
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer ukedagen (fra 1 til 7 der 1 representerer søndag) for datoverdiene i feltet DateofSale. |
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer ukenummeret (fra 1 til 52) for datoverdiene i feltet DateofSale. |
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Returnerer «Time» for datoverdiene i feltet «DateTime». |
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
Returnerer minutter for datoverdiene i feltet DateTime. |
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
Returnerer sekundene for datoverdiene i feltet DateTime. |
VBA-eksempel
Obs!: I eksemplene nedenfor vises bruken av denne funksjonen i en VBA-modul (Visual Basic for Applications). Hvis du vil ha mer informasjon om hvordan du arbeider med VBA, velger du Utviklerreferanse fra rullegardinlisten ved siden av Søk og skriver inn ett eller flere søkeord i søkeboksen.
Dette eksemplet tar en dato, og bruker DatePart-funksjonen til å vise kvartalet i året der den forekommer.
Dim TheDate As Date ' Declare variables.
Dim Msg TheDate = InputBox("Enter a date:") Msg = "Quarter: " & DatePart("q", TheDate) MsgBox Msg