Функция DateSerial

Возвращает значение типа Variant (Date) для указанного года, месяца и дня.

Синтаксис

DateSerial ( год, месяц, день )

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

Аргумент

Описание

год

Обязательный аргумент типа Integer. Число от 100 до 9999 включительно или числовое выражение.

месяц

Обязательный аргумент типа Integer. Любое числовое выражение.

день

Обязательный аргумент типа Integer. Любое числовое выражение.


Замечания

Чтобы указать дату, например 31 декабря 1991 года, числа для каждого аргумента функции DateSerial должны находиться в допустимом диапазоне для данного элемента, то есть 1–31 для дней и 1–12 для месяцев. Однако можно указать относительные даты для каждого аргумента, используя любое числовое выражение, представляющее число дней, месяцев или лет до или после определенной даты.

В следующем примере вместо абсолютных значений, составляющих дату, используются числовые выражения. Функция DateSerial возвращает дату, на один день предшествующую первому числу (1 - 1), на два месяца предшествующую августу (8 - 2) и на 10 лет предшествующую 1990 году (1990 - 10), то есть 31 мая 1980 года.

DateSerial(1990 - 10, 8 - 2, 1 - 1)

Значения аргумента год, заданные двумя цифрами, интерпретируются на основе заданных пользователем параметров системы. По умолчанию значения от 0 до 29 включительно интерпретируются как 2000–2029 годы; значения от 30 до 99 интерпретируются как 1930–1999 годы. Для других значений аргумента год используйте четырехзначные значения (например, 1800).

Версии Windows, предшествующие Windows 2000, интерпретируют двузначные годы в соответствии с заданными по умолчанию параметрами, описанными выше. Для полной уверенности в том, что функция вернет нужное значение, лучше использовать четырехзначный формат.

Если значение аргумента лежит вне допустимого диапазона, изменяется значение следующего по величине элемента. Например, если указать 35 дней, то это значение будет оценено как один месяц и несколько дней (в зависимости от того, на какую часть года оно приходится). Если отдельный аргумент имеет значение, лежащее вне диапазона от -32 768 до 32 767, возникает ошибка. Если дата, указанная с помощью трех аргументов, не соответствует допустимому диапазону, возникает ошибка.

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

Возвращаемая часть даты указывается в единицах времени текущего календаря Visual Basic. Например, если текущим календарем является Хиджра, а возвращаемой частью даты — год, значение года будет соответствовать году в календаре Хиджра. Для аргумента год значения от 0 до 99 включительно интерпретируются как 1400–1499 годы. Для всех остальных значений года используйте четырехзначные значения (например, 1520).

Пример

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

В данном примере функция DateSerial возвращает дату для указанных года, месяца и дня.

Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.

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

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

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

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

×