Atgriež Variant (Integer) vērtību, kas ietver konkrēta datuma norādīto daļu.
|
Brīdinājums Šo funkciju var lietot, izmantojot šādu problēmu. Dažu kalendāra gadu pēdējo pirmdienu var atgriezt kā 53. nedēļu, ja tai ir jābūt 1. nedēļai. Papildinformāciju un risinājumu skatiet rakstā Formatēšana vai DatePart funkcijas var atgriezt nepareizu nedēļas numuru pagājušajā pirmdienā gadā. |
Sintakse
DatePart ( intervāls, datums [, pirmā_nedēļas_diena] [, pirmā_gada_nedēļa] )
Funkcijas DatePart sintaksē ir šādi argumenti:
|
Arguments |
Apraksts |
|
intervāls |
Obligāts arguments. Virknes izteiksme, kas ir atgriežamā laika intervāls. |
|
date |
Obligāts arguments. Variant (Date) vērtība, kuru vēlaties novērtēt. |
|
pirmā_nedēļas_diena |
Neobligāts arguments. A konstante kas norāda nedēļas pirmo dienu. Ja nav norādīta, tiek pieņemts, ka tā ir svētdiena. |
|
pirmā_gada_nedēļa |
Neobligāts arguments. Konstante, kas norāda gada pirmo nedēļu. Ja nav norādīta, tiek pieņemts, ka pirmā nedēļa ir nedēļa, kurā ir 1. janvāris. |
Iestatījumi
Intervāla argumentam ir šādi iestatījumi:
|
Iestatījums |
Apraksts |
|
gggg |
Gads |
|
q |
Ceturksnis |
|
m |
Mēnesis |
|
y |
Gada diena |
|
d |
Diena |
|
w |
Weekday |
|
ww |
Nedēļa |
|
h |
Stunda |
|
n |
Minūte |
|
s |
Sekunde |
Argumentam pirmā_nedēļas_diena ir šādi iestatījumi:
|
Konstante |
Vērtība |
Apraksts |
|
vbUseSystem |
0 |
Izmantojiet NLS API iestatījumu. |
|
vbSunday |
1 |
Svētdiena (noklusējums) |
|
vbMonday |
2 |
Pirmdiena |
|
vbTuesday |
3 |
Otrdiena |
|
vbWednesday |
4 |
Trešdiena |
|
vbThursday |
5 |
Ceturtdiena |
|
vbFriday |
6 |
Piektdiena |
|
vbSaturday |
7 |
Sestdiena |
Argumentam pirmā_gada_nedēļa ir šādi iestatījumi:
|
Konstante |
Vērtība |
Apraksts |
|
vbUseSystem |
0 |
Izmantojiet NLS API iestatījumu. |
|
vbFirstJan1 |
1 |
Sākas ar nedēļu, kurā ir 1. janvāris (noklusējums). |
|
vbFirstFourDays |
2 |
Sāciet ar pirmo nedēļu, kurā jaunajā gadā ir vismaz četras dienas. |
|
vbFirstFullWeek |
3 |
Sāciet ar pirmo pilno gada nedēļu. |
Piezīmes
Varat izmantot funkciju DatePart , lai novērtētu datumu un atgrieztu noteiktu laika intervālu. Piemēram, varat izmantot DatePart , lai aprēķinātu nedēļas dienu vai pašreizējo stundu.
Arguments pirmā_nedēļas_diena ietekmē aprēķinus, kuros tiek lietoti intervāla "w" un "ww" simboli.
Ja date ir datuma literālis, norādītais gads kļūst par šī datuma pastāvīgu daļu. Tomēr, ja datums ir iekļauts pēdiņās (" "), un gads tiek izlaists, kods tiek ievietots katru reizi, kad tiek novērtēta datuma izteiksme. Tas ļauj rakstīt kodu, ko var izmantot dažādos gados.
Piezīme.: Datumam, ja rekvizīta Kalendārs iestatījums ir Gregora kalendārs, nodrošinātā datumam ir jābūt Gregora kalendāram. Ja kalendārs ir Hidžras, nodrošinātā datuma vērtībai ir jābūt Hidžras.
Atgrieztā datuma daļa ir pašreizējā arābu valodas kalendāra laika perioda mērvienībās. Piemēram, ja pašreizējais kalendārs ir Hidžras kalendārs un atgriežamā datuma daļa ir gads, gada vērtība ir Hidžras gads.
Vaicājumu piemēri
|
Izteiksme |
Rezultāti |
|
SELECT DatePart("yyyy",[DatumsPārdošanas]) AS NewDate FROM ProductSales; |
Atgriež lauka "Datums_ pēcpārdošanas" datumu vērtības "Gads". |
|
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Atgriež lauka "Pārdošanas datums" datumu vērtību "Ceturksnis" (atbilstoši kalendāra gadam). |
|
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Atgriež lauka "Gada diena" (no 1 līdz 365) datuma vērtību laukam "Datumspārdošanas datums". |
|
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Atgriež lauka "Pārdošanas datums" datumu vērtību "Diena". |
|
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Atgriež lauka "Nedēļas_diena" datumu vērtības (no 1 līdz 7, kur 1 apzīmē svētdienas) lauka "Datumspārdošanas datums". |
|
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Atgriež lauka "Datumspārdošanas datums" datumu vērtību "Nedēļas numurs" (no 1 līdz 52). |
|
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Atgriež lauka "DateTime" datumu vērtību "Hour". |
|
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
Atgriež lauka "DateTime" datumu vērtību "Minūtes". |
|
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
Atgriež lauka "DateTime" datumu vērtību "sekundes". |
VBA piemērs
Piezīme.: Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Lai iegūtu papildinformāciju par darbu ar VBA, nolaižamajā sarakstā atlasiet Uzziņas materiāli izstrādātājiem blakus meklēšanas lodziņam un ievadiet šajā lodziņā vienu vai vairākus vārdus.
Šajā piemērā tiek izmantots datums, un, izmantojot funkciju DatePart , tiek parādīts tā gada ceturksnis, kurā tas notiek.
Dim TheDate As Date ' Declare variables.Dim Msg TheDate = InputBox("Enter a date:")Msg = "Quarter: " & DatePart("q", TheDate)MsgBox Msg
