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.

×