Връща стойност от тип Variant (Integer), съдържаща указаната част от дадена дата.
| Предупреждение Има проблем с използването на тази функция. Последният понеделник в някои календарни години може да бъде върнат като седмица 53, когато трябва да бъде седмица 1. За повече информация и заобиколно решение вижте Функциите Format или DatePart могат да връщат грешен номер на седмица за последния понеделник в годината. |
|---|
Синтаксис
DatePart(интервал; дата [, първи ден от седмицата] [, първа седмица от годината] )
Синтаксисът на функцията DatePart има следните аргументи:
| Аргумент | Описание |
|---|---|
| интервал | Задължително. Израз във формата на низ, представляващ интервала от време, който искате да върнете. |
| Дата | Задължително. Стойност от тип Variant (Date), която искате да оцените. |
| първи ден от седмицата | Незадължително. Константа, която указва първия ден от седмицата. Ако не бъде указан, се приема "Неделя". |
| първа седмица от годината | Незадължително. Константа, която указва първата седмица от годината. Ако не бъде указана, се приема, че първата седмица е седмицата, в която настъпва 1 януари. |
Настройки
Аргументът за интервал има следните настройки:
| Настройка | Описание |
|---|---|
| yyyy | Година |
| q | Тримесечие |
| m | Месец |
| y | Ден от годината |
| d | Ден |
| w | Weekday |
| ww | Седмица |
| ч | Час |
| м | Минута |
| с | Секунда |
Първият аргумент от седмицата има следните настройки:
| Постоянно | Value | Описание |
|---|---|---|
| vbUseSystem | 0 | Използвайте настройката за NLS API. |
| vbSunday | 1 | Неделя (по подразбиране) |
| vbMonday | 2 | Понеделник |
| vbTuesday | 3 | Вторник |
| vbWednesday | 4 | Сряда |
| vbThursday | 5 | Четвъртък |
| vbFriday | 6 | Петък |
| vbSaturday | 7 | Събота. |
Първият аргумент от годината има следните настройки:
| Постоянно | Value | Описание |
|---|---|---|
| vbUseSystem | 0 | Използвайте настройката за NLS API. |
| vbFirstJan1 | 1 | Започнете със седмицата, в която се случва 1 януари (по подразбиране). |
| vbFirstFourDays | 2 | Започнете с първата седмица, която има поне четири дни през новата година. |
| vbFirstFullWeek | 3 | Започнете с първата пълна седмица от годината. |
Забележки
Можете да използвате функцията DatePart , за да оцените дата и да върнете конкретен интервал от време. Например можете да използвате DatePart , за да изчислите деня от седмицата или текущия час.
Аргументът "първи ден от седмицата " засяга изчисления, които използват символите за интервал "w" и "ww".
Ако дата е литерал за дата, указаната година става постоянна част от тази дата. Ако обаче дата е оградени с двойни кавички (" ") и пропуснете годината, текущата година се вмъква във вашия код всеки път, когато се изчислява изразът за дата . Това дава възможност да пишете код, който може да се използва в различни години.
Забележка
Ако настройката на свойството Calendar е григорианска, подадената дата трябва да бъде григорианска. Ако календарът е хиджри, предоставената дата трябва да бъде Хиджри.
Върнатата част за дата е в мерните единици за времевия период на текущия арабски календар. Ако например текущият календар е Хиджри и частта от датата, която трябва да бъде върната, е годината, стойността за годината е година хиджри.
Примери за заявки
| Израз | Резултати |
|---|---|
| SELECT DatePart("гггг";[DateofSale]) AS NewDate FROM ProductSales; | Връща "Year" на стойностите на датите на полето "DateofSale". |
| SELECT DatePart("q";[DateofSale]) AS NewDate FROM ProductSales; | Връща "Тримесечие" (базирано на календарна година) на стойностите на датите на полето "DateofSale". |
| SELECT DatePart("y";[DateofSale]) AS NewDate FROM ProductSales; | Връща "Ден от годината" (от 1 до 365) на стойностите за дата на полето "DateofSale". |
| SELECT DatePart("d";[DateofSale]) AS NewDate FROM ProductSales; | Връща "Day" на стойностите за дата на полето "DateofSale". |
| SELECT DatePart("w";[DateofSale]) AS NewDate FROM ProductSales; | Връща "Weekday" (от 1 до 7, където 1 представлява неделя) на стойностите за дата на полето "DateofSale". |
| SELECT DatePart("ww";[DateofSale]) AS NewDate FROM ProductSales; | Връща "Номер на седмица" (от 1 до 52) на стойностите за дата на полето "DateofSale". |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | Връща "Hour" на стойностите на датите на полето "DateTime". |
| SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductSales; | Връща "Минути" на датите на полето "DateTime". |
| SELECT DatePart("s";[DateTime]) AS NewDate FROM ProductSales; | Връща "seconds" на стойностите на датите на полето "DateTime". |
Пример на VBA
Забележка
Примерите по-долу илюстрират използването на тази функция във Visual Basic for Applications (VBA). За повече информация относно работата с VBA изберете Справочни материали за разработчици в падащия списък до Търсене и въведете един или няколко термина в полето за търсене.
Този пример приема дата и с помощта на функцията DatePart показва тримесечието от годината, в която се извършва.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg