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