Връща стойност от тип Variant (Integer), съдържаща указаната част от дадена дата.
|
Предупреждение Има проблем с използването на тази функция. Последният понеделник в някои календарни години може да бъде върнат като седмица 53, когато трябва да бъде седмица 1. За повече информация и заобиколно решение вижте Функциите Format или DatePart могат да връщат грешен номер на седмица за последния понеделник в годината. |
Синтаксис
DatePart ( интервал; дата [, първи ден от седмицата] [, първа седмица от годината] )
Синтаксисът на функцията DatePart има следните аргументи:
|
Аргумент |
Описание |
|
интервал |
Задължително. Израз във формата на низ, представляващ интервала от време, който искате да върнете. |
|
date |
Задължително. Стойност от тип 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".
Ако date е валиден формат за дата, указаната година става постоянна част от тази дата. Ако обаче дата е оградени с двойни кавички (" ") и пропуснете годината, текущата година се вмъква във вашия код всеки път, когато се изчислява изразът за дата . Това дава възможност да пишете код, който може да се използва в различни години.
Забележка: За дата, ако настройката на свойството Календар е Григорианска, подадената дата трябва да бъде григориански. Ако календарът е хиджри, предоставената дата трябва да бъде Хиджри.
Върнатата част за дата е в мерните единици за времевия период на текущия арабски календар. Ако например текущият календар е Хиджри и частта от датата, която трябва да бъде върната, е годината, стойността за годината е година хиджри.
Примери за заявки
|
Израз |
Резултати |
|
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
