Повертає значення типу Variant (Integer), яке містить указану частину заданої дати.
Попередження Виникла проблема з використанням цієї функції. Останній понеділок у деякі календарні роки можна повернути як тиждень 53, коли це буде тиждень 1. Докладні відомості та способи вирішення див. в статті Функції Format або DatePart можуть повертати неправильний номер тижня за минулий понеділок року. |
Синтаксис
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
Синтаксис функції DatePart має такі аргументи:
Аргумент |
Опис |
interval |
Обов’язковий аргумент. Рядковий вираз, який є інтервалом часу, який потрібно повернути. |
date |
— обов’язковий аргумент. Значення Variant (Date), яке потрібно обчислити. |
firstdayofweek |
Необов’язковий аргумент. Константа, яка задає перший день тижня. Якщо це значення не задано, вважається, що це неділя. |
firstweekofyear |
Необов’язковий аргумент. Константа, яка задає перший день року. Якщо це значення не задано, першим тижнем вважається тиждень, у який настає 1 січня. |
Параметри
Аргумент interval має такі параметри:
Параметр |
Опис |
yyyy |
Рік |
q |
Квартал |
m |
Місяць |
y |
День року |
d |
День |
w |
День тижня |
ww |
Тиждень |
h |
Година |
n |
Хвилина |
s |
Секунда |
Аргумент firstdayofweek має такі параметри:
Константа |
Значення |
Опис |
vbUseSystem |
0 |
Використовуйте параметр API NLS. |
vbSunday |
1 |
Неділя (за замовчуванням) |
vbMonday |
2 |
Понеділок |
vbTuesday |
3 |
Вівторок |
vbWednesday |
4 |
Середа |
vbThursday |
5 |
Четвер |
vbFriday |
6 |
П’ятниця |
vbSaturday |
7 |
Субота |
Аргумент firstweekofyear має такі параметри:
Константа |
Значення |
Опис |
vbUseSystem |
0 |
Використовуйте параметр API NLS. |
vbFirstJan1 |
1 |
Почати з тижня, до якого належить 1 січня (за замовчуванням). |
vbFirstFourDays |
2 |
Почати з першого тижня, який має принаймні чотири дні нового року. |
vbFirstFullWeek |
3 |
Почати з першого повного тижня року. |
Примітки
За допомогою функції DatePart можна обчислити дату та повернути певний інтервал часу. Наприклад, за допомогою функції DatePart можна обчислити день тижня або поточну годину.
Аргумент firstdayofweek впливає на обчислення, у яких використовуються символи проміжку часу "w" і "ww".
Якщо date – це літерал дати, указаний рік стає постійною частиною цієї дати. Однак, якщо дата взята в подвійні лапки (" "), і ви не пропустите рік, поточний рік вставляється в код щоразу, коли обчислюється вираз дати . Це дає змогу написати код, який можна використовувати в різні роки.
Примітка.: Для дати, якщо властивість Calendar має значення Gregorian, указана дата має бути григоріанським календарем. Якщо це календар хіджри, отримана дата відповідатиме цьому календарю.
Частина дати, що повертається, міститься в одиницях часу поточного арабського календаря. Наприклад, якщо поточний календар – Хіджри, а вам потрібно повернути рік, то значення року виражається як рік Хіджри.
Приклади запитів
Вираз |
Результати |
SELECT DatePart("yyyy";[DateofSale]) AS NewDate FROM ProductSales; |
Повертає значення дати "Рік" поля "DateofSale". |
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Повертає "Квартал" (на основі календарного року) значень дат поля "DateofSale". |
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Повертає "День року" (від 1 до 365) значень дати поля "Дата_продажу". |
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Повертає значення дати "День" поля "DateofSale". |
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Повертає значення дати "День тижня" (від 1 до 7, де 1 представляє неділю) значення дати поля "Дата_продажу". |
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Повертає значення дати поля "Дата_продажу" (від 1 до 52) (від 1 до 52). |
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Повертає значення дати "Година" поля "Дата й час". |
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
Повертає значення дати "Хвилини" поля "Дата й час". |
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
Повертає значення дати "секунди" поля "Дата й час". |
Приклад 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