Applies ToAccess для Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Повертає значення типу 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

Вибір правильної функції дати

Потрібна додаткова довідка?

Потрібні додаткові параметри?

Ознайомтеся з перевагами передплати, перегляньте навчальні курси, дізнайтесь, як захистити свій пристрій тощо.

Спільноти допомагають ставити запитання й відповідати на них, надавати відгуки та дізнаватися думки висококваліфікованих експертів.