Funktsioon DatePart

Tagastab variandi (täisarvu), mis sisaldab märgitud kuupäeva määratud osa.

Hoiatus Selle funktsiooni kasutamisega on probleeme. Mõne kalendriaasta viimase esmaspäeva saab tagastada 53. nädalana, kui see peaks olema 1. nädal. Lisateavet ja lahendust leiate teemast Funktsioonid Format või DatePart võivad tagastada vale nädalanumbri aasta viimase esmaspäeva jaoks.

Süntaks

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

Funktsiooni DatePart süntaksil on järgmised argumendid.

Argument	Kirjeldus
interval	Nõutav. Stringavaldis, mis tähistab ajavahemikku, mida soovite tagastada.
date	Nõutav. Variandi (kuupäeva) väärtus, mida soovite hinnata.
firstdayofweek	Valikuline. Nädala esimest päeva määrav konstant. Kui seda pole määratud, siis eeldatakse, et see on pühapäev.
firstweekofyear	Valikuline. Konstant, mis määratleb aasta esimese nädala. Kui seda pole määratud, eeldatakse, et esimene nädal on 1. jaanuari nädal.

Sätted

Argumendil interval on järgmised sätted.

Säte	Kirjeldus
yyyy	Aasta
q	Kvartal
m	Kuu
y	Kuupäev
d	Päev
w	Nädalapäev
ww	Nädal
h	Tund
n	Minut
s	Sekund

Argumendil firstdayofweek on järgmised sätted.

Konstant	Väärtus	Kirjeldus
vbUseSystem	0	Kasutage NLS API sätet.
vbSunday	1	Pühapäev (vaikeväärtus)
vbMonday	2	Esmaspäev
vbTuesday	3	Teisipäev
vbWednesday	4	Kolmapäev
vbThursday	5	Neljapäev
vbFriday	6	Reede
vbSaturday	7	Laupäev

Argumendil firstweekofyear on järgmised sätted.

Konstant	Väärtus	Kirjeldus
vbUseSystem	0	Kasutage NLS API sätet.
vbFirstJan1	1	Alustage 1. jaanuari nädalast (vaikeväärtus).
vbFirstFourDays	2	Alustage esimesest nädalast, mille päevadest vähemalt neli jääb uude aastasse.
vbFirstFullWeek	3	Alustatakse aasta esimesest täisnädalast.

Kommentaarid

Funktsiooni DatePart abil saate hinnata kuupäeva ja tagastada konkreetse ajavahemiku. Näiteks saate funktsiooniga DatePart arvutada välja nädalapäeva või praeguse kellaaja (tunni).

Argument firstdayofweek mõjutab arvutusi, mis kasutavad intervallisümboleid "w" ja "ww".

Kui kuupäev on kuupäevaliteraal, muutub määratud aasta selle kuupäeva püsivaks osaks. Kui date on jutumärkides (" ") ja aasta on välja jäetud, siis sisestatakse iga kord, kui argumendi date avaldist hinnatakse, koodi praegune aasta. Nii on võimalik kirjutada koodi, mida saab kasutada eri aastatel.

Tagastatav kuupäevaosa on praeguse Araabia kalendri ajaperioodi ühikutes. Näiteks kui kasutusel on islami kalender ja kuupäevaosana tagastatakse aasta, on aasta väärtus islami kalendri põhine.

Päringu näited

Avaldis	Tulemid
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	Tagastab välja "DateofSale" kuupäevaväärtuste aastaväärtuse.
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Tagastab välja "DateofSale" kuupäevaväärtuste kvartali (kalenderaasta alusel).
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	Tagastab välja "DateofSale" kuupäevaväärtuste "Day of Year" (1–365).
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;	Tagastab välja "DateofSale" kuupäevaväärtuste päevaväärtuse.
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;	Tagastab välja "DateofSale" kuupäevaväärtuste nädalapäeva (vahemikus 1–7, kus 1 tähistab pühapäeva).
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	Tagastab välja "DateofSale" kuupäevaväärtuste nädalanumbri (vahemikus 1–52).
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Tagastab välja "DateTime" kuupäevaväärtuste tunniväärtuse.
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;	Tagastab välja "DateTime" kuupäevaväärtuste minutites.
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	Tagastab välja "DateTime" kuupäevaväärtuste sekundite väärtuse.

VBA näide

Selles näites võetakse kuupäev ja leitakse funktsiooni DatePart kasutades kvartal, millesse see kuulub.

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

Õige kuupäevafunktsiooni valimine