Функция DatePart

Важно :  Данная статья переведена с помощью машинного перевода, см. Отказ от ответственности. Используйте английский вариант этой статьи, который находится здесь, в качестве справочного материала.

Возвращает значение типа Variant (Integer), содержащее указанную часть заданной даты.

Синтаксис

DatePart ( интервал, дата [, первый_день_недели] [, первая_неделя_года] )

Синтаксис функции DatePart имеет следующие аргументы:

Аргумент

Описание

интервал

Обязательно. Строковое выражение, определяющее интервал времени, которые нужно вернуть.

Дата

Обязательно. Variant Значение (Дата), которое вы хотите вычислить.

первый_день_недели

Необязательный аргумент: константа, указывающая первый день недели. Если аргумент не указан, предполагается значение "Воскресенье".

первая_неделя_года

Необязательный аргумент: константа, указывающая первую неделю года. Если аргумент не указан, первой считается неделя, на которую приходится 1 января.


Настройка документа

Аргумент интерваларгумент имеет следующие значения:

Параметр

Описание

yyyy

Год

q

Квартал

m

Месяц

y

День года

d

День

w

День недели

ww

Неделя

h

Часы

n

Минуты

s

Секунды


Аргумент первый_день_недели может принимать следующие значения:

Константа

Значение

Описание

vbUseSystem

0

Используются параметры API NLS.

vbSunday

1

Воскресенье (по умолчанию)

vbMonday

2

Понедельник

vbTuesday

3

Вторник

vbWednesday

4

Среда

vbThursday

5

Четверг

vbFriday

6

Пятница

vbSaturday

7

Суббота


Аргумент первая_неделя_года имеет следующие параметры:

Константа

Значение

Описание

vbUseSystem

0

Используются параметры API NLS.

vbFirstJan1

1

Начинается с недели, на которую приходится 1 января (по умолчанию).

vbFirstFourDays

2

Первой неделей считается та, которая содержит хотя бы четыре дня нового года.

vbFirstFullWeek

3

Первой неделей считается первая полная неделя года.


Замечания

Функция DatePart для вычисления даты и возврата определенного периода времени. Например с помощью функции DatePart для вычисления дня недели или текущего часа.

Аргумент первый_день_недели влияет на вычисления, если заданы значения "w" и "ww".

Если dateлитерал даты заданный год становится постоянной частью даты. Тем не менее если значение даты заключено в двойные кавычки (» «) и опустить года, текущий год вставляется в код каждый раз, когда выражение даты . Это дает возможность написать код, который можно использовать в разных лет.

Примечание : Для датыЕсли свойства календаря указан григорианский календарь, должен быть указан григорианский календарь. Если календарь хиджра, предоставленный Дата должна быть хиджры.

Возвращаемая часть даты указывается в единицах времени текущего арабского календаря. Например если текущий календарь — хиджры, должны быть возвращены часть даты — год год значение год хиджры.

Пример

Примечание : В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.

В этом примере принимает даты и с помощью функции DatePart отображается квартал года, в котором находится.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Примечание : Отказ от ответственности относительно машинного перевода. Данная статья была переведена с помощью компьютерной системы без участия человека. Microsoft предлагает эти машинные переводы, чтобы помочь пользователям, которые не знают английского языка, ознакомиться с материалами о продуктах, услугах и технологиях Microsoft. Поскольку статья была переведена с использованием машинного перевода, она может содержать лексические,синтаксические и грамматические ошибки.

Совершенствование навыков
Перейти к обучению
Первоочередный доступ к новым возможностям
Присоединиться к программе предварительной оценки Office

Были ли сведения полезными?

Спасибо за ваш отзыв!

Благодарим за отзыв! Возможно, будет полезно связать вас с одним из наших специалистов службы поддержки Office.

×