Funktionen DatePart

Returnerer en variant (heltal), der indeholder den angivne del af en angiven dato.

Advarsel Der er et problem med brugen af denne funktion. Den sidste mandag i nogle kalenderår kan returneres som uge 53, hvor det skulle være uge 1. Du kan finde flere oplysninger og en løsning under Formatér eller DatePart-funktioner kan returnere forkerte ugenumre for sidste mandag i året.

Syntaks

DatePart(interval, dato [, første dag i ugen] [, første uge i året] )

Syntaksen for funktionen DatePart har disse argumenter:

Argument	Beskrivelse
interval	Påkrævet. Strengudtryk, der er det tidsinterval, du vil returnere.
Dato	Påkrævet. Variant (dato) værdi, som du vil evaluere.
førsteugedag	Valgfrit. En konstant, der angiver den første dag i ugen. Hvis andet ikke er angivet, antages dette at være søndag.
førsteuge	Valgfrit. En konstant, der angiver den første uge i året. Hvis denne ikke er angivet, antages det at være den uge, hvor 1. januar forekommer.

Indstillinger

Intervalargumentet har følgende indstillinger:

Indstilling	Beskrivelse
åååå	År
k	Kvartal
m	Måned
y	Dag i året
d	Dag
w	Ugedag
ww	Uge
h	Time
n	Minut
s	Sekund

Argumentet førsteugedag har følgende indstillinger:

Konstant	Værdi	Beskrivelse
vbUseSystem	0	Brug indstillingen 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ørsteuge i året har følgende indstillinger:

Konstant	Værdi	Beskrivelse
vbUseSystem	0	Brug indstillingen NLS API.
vbFirstJan1	1	Start med uge, hvor 1 januar forekommer (standard).
vbFirstFourDays	2	Start med den første uge, der har mindst fire dage i det nye år.
vbFirstFullWeek	3	Start med den første hele uge i året.

Bemærkninger

Du kan bruge funktionen DatePart til at evaluere en dato og returnere et bestemt tidsinterval. Du kan f.eks. bruge DatePart til at beregne ugedagen eller den aktuelle time.

Argumentet første ugedag påvirker beregninger, der anvender intervalsymbolerne "w" og "ww".

Hvis datoen er en datokonstant, bliver det angivne år en permanent del af den pågældende dato. Men hvis datoen er omsluttet af dobbelte anførselstegn (""), og du udelader året, indsættes det aktuelle år i din kode, hver gang datoudtrykket evalueres. Det gør det muligt at skrive kode, der kan bruges i forskellige år.

Den returnerede datodel er i tidsperiodeenhederne for den aktuelle arabiske kalender. Hvis den aktuelle kalender f.eks. er hijri, og den datodel, der skal returneres, er året, er årsværdien et hijri-år.

Eksempler på forespørgsel

Udtryk	Resultater
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer 'Year' for datoværdierne i feltet "DateofSale".
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer 'kvartalet' (baseret på kalenderår) for datoværdierne i feltet "Salgsdato".
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer 'Dag i året' (1 til 365) for datoværdierne i feltet "Salgsdato".
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer 'Dag' for datoværdierne i feltet "Salgsdato".
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer 'Ugedag' (fra 1 til 7, hvor 1 repræsenterer søndag) for datoværdierne i feltet "Salgsdato".
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	Returnerer 'Ugenummeret' (fra 1 til 52) for datoværdierne i feltet "Salgsdato".
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Returnerer 'timen' for datoværdierne i feltet "DateTime".
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;	Returnerer 'minutter' for datoværdierne i feltet "DateTime".
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	Returnerer 'sekunder' for datoværdierne i feltet "DateTime".

VBA-eksempel

Dette eksempel tager en dato, og ved hjælp af funktionen DatePart vises kvartalet i det år, hvor den forekommer.

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

Vælge den rigtige datofunktion