Pateikia variantą (sveikąjį skaičių), kuriame yra nurodyta duotos datos dalis.
Įspėjimas Iškilo šios funkcijos naudojimo problema. Kai kurių kalendorinių metų pirmadienis gali būti grąžintas kaip savaitė 53, kai ji turėtų būti 1 savaitė. Daugiau informacijos ir sprendimo būdus žr. Format arba DatePart funkcijos gali grąžinti netinkamą savaitės numerį praėjusį metų pirmadienį. |
Sintaksė
DatePart ( intervalas, data [, firstdayofweek] [, firstweekofyear] )
Funkcijos DatePart sintaksė turi tokius argumentus:
Argumentas |
Aprašas |
intervalas |
Būtinas. Eilutės reiškinys, kuris yra laiko intervalas, kurį norite pateikti. |
data |
Būtinas. Variant (Date) reikšmė, kurią norite įvertinti. |
firstdayofweek |
Pasirinktinis. konstanta, nurodantis pirmąją savaitės dieną. Jei nenurodyta, ja laikoma sekmadienis. |
firstweekofyear |
Pasirinktinis. Konstanta, nurodanti pirmąją metų savaitę. Jei nenurodyta, pirmąja savaite laikoma savaitė, kurią yra sausio 1 d. |
Parametrai
Intervalo argumentas turi šiuos parametrus:
Parametras |
Aprašas |
yyyy |
Metai |
q |
Ketvirtis |
m |
Mėnuo |
y |
Metų diena |
d |
Diena |
w |
Weekday |
ww |
Savaitė |
h |
Valanda |
n |
Minutė |
s |
Sekundė |
Argumentas firstdayofweek turi šiuos parametrus:
Konstanta |
Reikšmė |
Aprašas |
vbUseSystem |
0 |
Naudokite NLS API parametrą. |
vbSunday |
1 |
Sekmadienis (numatytasis parametras) |
vbMonday |
2 |
Pirmadienis |
vbTuesday |
3 |
Antradienis |
vbWednesday |
4 |
Trečiadienis |
vbThursday |
5 |
Ketvirtadienis |
vbFriday |
6 |
Penktadienis |
vbSaturday |
7 |
Šeštadienis |
Argumentas firstweekofyear turi šiuos parametrus:
Konstanta |
Reikšmė |
Aprašas |
vbUseSystem |
0 |
Naudokite NLS API parametrą. |
vbFirstJan1 |
1 |
Pradėkite nuo savaitės, kurią įvyksta sausio 1 d. (numatytoji reikšmė). |
vbFirstFourDays |
2 |
Pradėkite nuo pirmosios savaitės, kuri turi bent keturias dienas naujaisiais metais. |
vbFirstFullWeek |
3 |
Pradėkite nuo pirmos visos metų savaitės. |
Pastabos
Funkciją DatePart galite naudoti norėdami įvertinti datą ir grąžinti konkretų laiko intervalą. Pavyzdžiui, galite naudoti DatePart norėdami apskaičiuoti savaitės dieną arba dabartinę valandą.
Argumentas firstdayofweek turi įtakos skaičiavimams, kurie naudoja intervalo simbolius "w" ir "ww".
Jei date yra datos literalas, nurodyti metai tampa nuolatine tos datos dalimi. Tačiau, jei data yra tarp dvigubų kabučių (" "), o jūs praleidžiate metus, dabartiniai metai įterpiami į kodą kiekvieną kartą, kai įvertinamas datos reiškinys. Tai leidžia rašyti kodą, kuris gali būti naudojamas skirtingais metais.
Pastaba: Jei datos ypatybės Kalendorius parametras yra Grigaliaus, pateikta data turi būti Grigaliaus. Jei kalendorius yra Hidžros kalendorius, pateikiama data turi būti Hidžri.
Grąžinta datos dalis yra dabartinio arabų kalendoriaus laikotarpio vienetais. Pavyzdžiui, jei dabartinis kalendorius yra Hidžros kalendorius, o grąžintina datos dalis yra metai, metų reikšmė yra Hidžros metai.
Užklausų pavyzdžiai
Reiškinys |
Rezultatai |
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateofSale" datos reikšmių reikšmes "Year". |
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateofSale" datos reikšmes "Ketvirtis" (remiantis kalendorių metais). |
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina lauko DateofSale datos reikšmių 'Metų diena' (nuo 1 iki 365). |
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina lauko DateofSale datų reikšmių reikšmę Day. |
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateofSale" datos reikšmių "Weekday" (nuo 1 iki 7, kur 1 reiškia sekmadienį). |
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateofSale" datos reikšmių "Week number" (nuo 1 iki 52). |
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateTime" datos reikšmių "Hour". |
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateTime" datos reikšmių minutes . |
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
Grąžina lauko "DateTime" datos reikšmių sekundes. |
VBA pavyzdys
Pastaba: Pateiktuose pavyzdžiuose parodyta, kaip naudoti šią funkciją „Visual Basic for Applications“ (VBA) modulyje. Daugiau informacijos apie darbą su VBA rasite išplečiamajame sąraše pasirinkę Kūrėjų nuoroda (šalia Ieškos) ir ieškos lauke įvedę vieną ar daugiau sąlygų.
Šiame pavyzdyje naudojama data, o naudojant funkciją DatePart rodomas metų ketvirtis, kuriuo ji vyksta.
Dim TheDate As Date ' Declare variables.
Dim Msg TheDate = InputBox("Enter a date:") Msg = "Quarter: " & DatePart("q", TheDate) MsgBox Msg