Перейти к основному контенту
Office

Функция DatePart

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

Синтаксис

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

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

Аргумент

Описание

интервал

Обязательный. Строковое выражение, которое является интервалом времени, которое нужно вернуть.

дата

Обязательный аргумент. Вариант Значение (Date), которое вы хотите вычислить.

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

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

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

Необязательный аргумент. Константа, задающая первую неделю года. Если значение не указано, предполагается, что первая неделя является неделей, в которую входит 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 — литерал даты, указанный год становится неотъемлемой частью этой даты. Однако если значение аргумента " Дата " заключено в двойные кавычки (""), а год не указан, то текущий год вставляется в код каждый раз при вычислении выражения даты . Это позволяет писать код, который можно использовать для разных лет.

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

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

Примеры запросов

Выражение

Результаты:

Выберите раздел DatePart ("гггг", [Датеофсале]) в качестве Невдате от Продуктсалес;

Возвращает значение year для значений даты в поле "Датеофсале".

Выберите раздел DatePart ("q"; [Датеофсале]) в качестве Невдате от Продуктсалес;

Возвращает значение "квартал" (в зависимости от клиентами года) значений даты поля "Датеофсале".

Выберите раздел DatePart ("y" [Датеофсале]) в качестве Невдате от Продуктсалес;

Возвращает значение "Day Year" (от 1 до 365) значений даты в поле "Датеофсале".

Выберите раздел DatePart ("d"; [Датеофсале]) в качестве Невдате от Продуктсалес;

Возвращает значение Day для значений даты в поле "Датеофсале".

Выберите раздел DatePart ("w"; [Датеофсале]) в качестве Невдате от Продуктсалес;

Возвращает значение "Weekday" (от 1 до 7, где 1 — воскресенье) значений даты поля "Датеофсале".

Выберите раздел DatePart ("WW"; [Датеофсале]) в качестве Невдате от Продуктсалес;

Возвращает значение "номер недели" (от 1 до 52) значений даты в поле "Датеофсале".

SELECT DatePart ("h"; [DateTime]) как Невдате из Продуктсалес;

Возвращает значение "Hour" для значений даты поля "DateTime".

SELECT DatePart ("n"; [DateTime]) как Невдате из Продуктсалес;

Возвращает значение "minutes" для значений даты поля "Дата и время".

Выберите DatePart ("s"; [DateTime]) как Невдате из Продуктсалес;

Возвращает значение "секунды" для значений даты поля "DateTime".

Пример VBA

Примечание: В примерах ниже показано, как использовать эту функцию в модуле 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

Примечание:  Эта страница переведена автоматически, поэтому ее текст может содержать неточности и грамматические ошибки. Для нас важно, чтобы эта статья была вам полезна. Была ли информация полезной? Для удобства также приводим ссылку на оригинал (на английском языке).

См. также

Выберите нужную функцию даты

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

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

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

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

×