Перейти до основного
Office

Функція DatePart

Повертає значення типу Variant (Integer), яке містить указану частину заданої дати.

Синтаксис

DatePart ( інтервал, дата [, перший_ день _ тижня] [, перший_ тиждень] )

Синтаксис функції DatePart має такі аргументи:

Аргумент

Опис

interval

Обов’язковий аргумент. Текстовий вираз, який є інтервалом часу, який потрібно повернути.

date

– обов'язковий параметр. Варіант (Дата) значення, яке потрібно обчислити.

firstdayofweek

– необов'язковий параметр. Константа, яка задає перший день тижня. Якщо це значення не задано, вважається, що це неділя.

firstweekofyear

Необов’язковий аргумент. Константа, яка задає перший день року. Якщо це значення не задано, першим тижнем вважається тиждень, у який настає 1 січня.

Параметри

Інтервал аргумент має такі параметри:

Параметр

Опис

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 вибрано григоріанський, то дата, щододається, має бути григоріанський. Якщо це календар хіджри, отримана дата відповідатиме цьому календарю.

Повернуто частину дати в одиницях часу періоду поточного арабського календаря. Наприклад, якщо поточний календар – Хіджри, а вам потрібно повернути рік, то значення року виражається як рік Хіджри.

Приклади запитів

Вираз

Результати

Виберіть елемент DatePart ("РРРР", [DateofSale]) як NewDate від ProductSales;

Повертає «рік» значень дат поля "DateofSale".

Виберіть DatePart ("q", [DateofSale]) як Найновідату з ProductSales;

Повертає ' квартал ' (на основі календаря року) значення дати поля "DateofSale".

Виберіть DatePart ("y", [DateofSale]) як NewDate від ProductSales;

Повертає "день року" (від 1 до 365) значення дати поля "DateofSale".

Виберіть елемент DatePart ("d", [DateofSale]) як Найновідату з ProductSales;

Повертає "день" з значень дат поля "DateofSale".

Виберіть DatePart ("w", [DateofSale]) як NewDate від ProductSales;

Повертає "день тижня" (від 1 до 7, де 1 представляє недільну) значень дат поля "DateofSale".

Виберіть DatePart ("ww"; [Дата _ продажу]) як NewDate від ProductSales;

Повертає "номер тижня" (від 1 до 52) значення дати поля "DateofSale".

Виберіть елемент DatePart ("h", [Дата й час]) як Найновідату з ProductSales;

Повертає "година" значень дат поля "Дата й час".

Виберіть елемент DatePart ("n", [Дата й час]) як Найновідату з ProductSales;

Повертає "хвилини" значень дат поля "Дата й час".

Виберіть елемент DatePart ("s", [Дата й час]) як найновіша з 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

Примітка.:  Цю сторінку перекладено за допомогою засобу автоматичного перекладу, тому вона може містити смислові, синтаксичні або граматичні помилки. Ми вважаємо, що цей вміст стане вам у пригоді. Повідомте нас, чи була ця інформація корисною. Для довідки цю статтю можна переглянути англійською мовою.

Див. також

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

Удосконалення навичок роботи з Office
Ознайомтеся з навчальними матеріалами
Отримуйте нові функції раніше за інших
Приєднайтеся до оцінювачів Office

Ця інформація корисна?

Дякуємо за ваш відгук!

Дякуємо, що знайшли час і надіслали нам відгук! Можливо, у нас не буде часу відповісти на кожен коментар, але докладемо максимум зусиль, щоб переглянути їх усі. Вас цікавить, як ми використовуємо ваші відгуки?

×