Возвращает значение типа Variant (Integer), содержащее указанную часть заданной даты.
Об Возникла проблема с использованием этой функции. Последний понедельник в некоторых годовых годах может быть возвращен в неделю 53, когда она должна быть неделей 1. Дополнительные сведения и временное решение можно найти в статье функции Format и datepart могут возвращать неверный номер недели для последнего месяца в году. |
Синтаксис
DatePart ( интервал, Дата [, первый_день_недели] [, первая_неделя_года] )
Функция DatePart имеет следующие аргументы:
Аргумент | Описание |
---|---|
интервал |
— обязательный аргумент. Строковое выражение, которое является интервалом времени, которое нужно вернуть. |
дата |
Обязательный аргумент. Значение типа Variant (Date), которое вы хотите вычислить. |
первый_день_недели |
Необязательный. Константа, задающая первый день недели. Если не указано, предполагается воскресенье. |
первая_неделя_года |
Необязательный аргумент. Константа, задающая первую неделю года. Если значение не указано, предполагается, что первая неделя является неделей, в которую входит 1 января. |
Параметры
Аргумент Interval имеет следующие параметры:
Параметр | Описание |
---|---|
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