Функция DateSerial

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

Синтаксис

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

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

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

Замечания

Чтобы указать дату, например 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)

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

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

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

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