Повертає значення типу Variant (Integer), яке містить указану частину заданої дати.
| Попередження Виникла проблема з використанням цієї функції. Останній понеділок у деяких календарних роках може бути повернуто як тиждень 53, якщо це має бути тиждень 1. Докладні відомості та спосіб вирішення див. в статті "Формат" або "Функція DatePart може повертати неправильний номер тижня для останнього понеділка року. |
|---|
Синтаксис
DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )
Синтаксис функції DatePart має такі аргументи:
| Аргумент | Опис |
|---|---|
| interval | — обов’язковий аргумент. Рядковий вираз, який дорівнює кількості інтервалів часу, які необхідно додати. |
| Дата | — обов’язковий аргумент. Значення типу 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 можна обчислити день тижня або поточну годину.
Аргумент "перший_день_тижня " впливає на обчислення, у яких використовуються символи інтервалу "w" і "ww".
Якщо аргумент «дата » є літералом, то вказаний рік стає постійною частиною цієї дати. Однак, якщо дату взято в подвійні лапки (" ") і рік пропущено, то під час кожної оцінки виразу дати в код вставляється поточний рік. Це дає змогу написати код, який можна використовувати в різні роки.
Примітка.
Для date, якщо параметр Calendar властивості має бути григоріанським, то й отримана дата має бути григоріанською. Якщо це календар хіджри, отримана дата відповідатиме цьому календарю.
Частина дати, що повертається, виражається в одиницях часу поточного арабського календаря. Наприклад, якщо поточний календар – Хіджри, а вам потрібно повернути рік, то значення року виражається як рік Хіджри.
Приклади запитів
| Вираз | Результати. |
|---|---|
| SELECT DatePart("yyyy";[Датапродажу]) AS NewDate FROM ProductSales; | Повертає 'Рік' значень дати в полі "ДатаПродажу". |
| SELECT DatePart("q", [DateofSale]) AS NewDate FROM ProductSales; | Повертає ''Квартал' (на основі календаря року) значень дат у полі "Дата продажу". |
| SELECT DatePart("y";[DateofSale]) AS NewDate FROM ProductSales; | Повертає значення «День року» (від 1 до 365) значень дати поля «Дата продажу». |
| SELECT DatePart("d";[DateofSale]) AS NewDate FROM ProductSales; | Повертає значення «День» дати в полі «ДатаПродажу». |
| SELECT DatePart("w";[DateofSale]) AS NewDate FROM ProductSales; | Повертає значення 'Тиждень' (від 1 до 7, де 1 відповідає неділі) значень дати в полі "ДатаПродажу". |
| SELECT DatePart("ww";[DateofSale]) AS NewDate FROM ProductSales; | Повертає 'Номер тижня' (від 1 до 52) значень дат у полі "ДатаПродажу". |
| SELECT DatePart("h";[DateTime]) AS NewDate FROM ProductSales; | Повертає 'Годину' значень дат у полі "ДатаЧас". |
| SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductSales; | Повертає 'Minutes' значень дат у полі "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