DatePart-funksjon

Returnerer en variant (heltall) som inneholder den angitte delen av en gitt dato.

Advarsel Det er et problem med bruken av denne funksjonen. Siste mandag i noen kalenderår kan returneres som uke 53 når det skulle vært uke 1. Hvis du vil ha mer informasjon og en midlertidig løsning, kan du se Format- eller DatePart-funksjoner kan returnere feil ukenummer for siste mandag i år.

Syntaks

DatePart(interval; date [, firstdayofweek] [, firstweekofyear] )

Syntaksen for funksjonen DatePart har disse argumentene:

Argumenter	Beskrivelse
intervall	Obligatorisk. Strenguttrykk som er tidsintervallet du vil legge til.
Dato	Obligatorisk. Variantverdien (datoen) 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 første uke i året. Hvis den ikke er angitt, brukes uken der datoen 1. januar finnes.

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	Verdi	Beskrivelse
vbUseSystem	0	Bruk innstillingen for NLS API.
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 første uke i året har disse innstillingene:

Konstant	Verdi	Beskrivelse
vbUseSystem	0	Bruk innstillingen for NLS API.
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 den første hele uken 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 den gjeldende timen.

Argumentet første dag i uken påvirker beregninger som bruker intervallsymbolene "w" og "ww".

Hvis dato er en datolitteral, blir det angitte året en permanent del av denne datoen. Hvis dato er omsluttet av doble anførselstegn (" "), og året utelates, settes imidlertid gjeldende år inn i koden hver gang datouttrykket evalueres. Dette gjør det mulig å skrive kode som kan brukes i forskjellige år.

Den returnerte datodelen er i tidsperiodeenheten i den gjeldende arabiske kalenderen. Hvis for eksempel den gjeldende kalenderen er Hijri og datodelen som skal returneres, er året, er årsverdien et Hijri-år.

Eksempler på spørringer

Uttrykk	Resultater
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer året for datoverdiene for feltet «Salgsdato».
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer kvartalet (basert på kalenderår) for datoverdiene i feltet "Salgsdato".
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer dagen i året (1 til 365) for datoverdiene i feltet Salgsdato.
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer dagen for datoverdiene i feltet «Salgsdato».
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer ukedagen (fra 1 til 7 der 1 representerer søndag) for datoverdiene i feltet «Salgsdato».
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer ukenummeret (fra 1 til 52) for datoverdiene i feltet Salgsdato.
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Returnerer timeverdien 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 sekunder av datoverdiene for feltet DateTime.

VBA-eksempel

Dette eksemplet tar en dato, og viser ved hjelp av DatePart-funksjonen kvartalet i året den forekommer.

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

Velge riktig datofunksjon