Повернення значення типу Variant (Date) для вказаного року, місяця та дня.
Синтаксис
DateSerial (рік, місяць, день)
Попередження Переконайтеся, що аргументи розташовано в правильному діапазоні значень. Неприпустимий аргумент може призвести до неправильного результату.
Синтаксис функції DateSerial має такі аргументи:
| Аргумент | Опис |
|---|---|
| рік | — обов’язковий аргумент. Типу Integer. Число від 100 до 9999 включно або числовий вираз. |
| місяць | — обов’язковий аргумент. Типу Integer. Будь-який числовий вираз. |
| day | — обов’язковий аргумент. Типу 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 є григоріанським, то й отримане значення приймається за григоріанське. Якщо властивість Calendar має значення Hijri, то й отримане значення відповідатиме ісламському календарю Хіджри.
Частина дати, що повертається, виражається в одиницях часу поточного календаря Visual Basic. Наприклад, якщо поточний календар – Хіджри, а вам потрібно повернути рік, то значення року виражається як рік Хіджри. Для аргументованого року значення в діапазоні від 0 до 99 включно інтерпретуються як роки 1400–1499. Для всіх значень інших років використовуйте повний чотиризначний рік (наприклад, 1520).
Приклад запиту
| Вираз | Результати. |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Повертає "дату" вказаного року, місяця та дня, введених в аргументах функції та відображає у стовпці "Нова_дата". Результат: "13/12/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.