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 |
Kasutatakse 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 |
Kasutatakse NLS API sätet. |
|
vbFirstJan1 |
1 |
Alustage 1. jaanuari nädalast (vaikeväärtus). |
|
vbFirstFourDays |
2 |
Alustatakse esimesest nädalast, millel on uues aastas vähemalt neli päeva. |
|
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, kus kasutatakse vahemikusümboleid „w” ja „ww”.
Kui date on kuupäevaliteraal, saab 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.
Märkus.: Kui argumendi date atribuudi Kalender sätteks on „Gregorius“, peate esitama Gregoriuse kalendri kuupäeva. Islami kalendri korral tuleb kasutada islami kalendri ajaarvestusele vastavat kuupäeva.
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
Märkus.: Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
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
