Возвращает значение типа Variant (Date) для указанного года, месяца и дня.
Синтаксис
DateSerial ( год, месяц, день )
Внимание! Убедитесь, что аргументы находятся в правильном диапазоне значений. Недопустимый аргумент может привести к неправильному результату.
Функция DateSerial имеет следующие аргументы:
|
Аргумент |
Описание |
|
год |
Обязательный. Целое число. Число от 100 до 9999 включительно или числовое выражение. |
|
месяц |
Обязательный. Целое число. Любое числовое выражение. |
|
день |
Обязательный. Целое число. Любое числовое выражение. |
Замечания
Чтобы указать дату, например 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, возникает ошибка. Если дата, указанная с помощью трех аргументов, не соответствует допустимому диапазону, возникает ошибка.
Примечание: Если для свойства Calendar задано значение Gregorian, год, месяци день следует указывать соответствующим образом. Если для свойства Calendar задано значение Hijri, дату следует указывать в соответствии с летоисчислением по Хиджре.
Возвращаемая часть даты указывается в единицах времени текущего календаря Visual Basic. Например, если текущим календарем является Хиджра, а возвращаемой частью даты — год, значение года будет соответствовать году в календаре Хиджра. Для аргумента год значения от 0 до 99 включительно интерпретируются как 1400–1499 годы. Для всех остальных значений года используйте четырехзначные значения (например, 1520).
Пример запроса
|
Expression |
Результаты |
|
SELECT Dateserial(2018;12;13) AS NewDate FROM ProductSales; |
Возвращает значение date для указанного года, месяца и дня, введенных в аргументах функции, и отображается в столбце NewDate. Результат: "12.13.2018". |
Пример VBA
Примечание: В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.
В данном примере функция DateSerial возвращает дату для указанных года, месяца и дня.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.
