Повернення значення типу 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).

Приклад запиту

Вираз

Результати

Виберіть DateSerial (2018 р., 12, 13) як Найновідату з ProductSales;

Повертає значення "Дата" для вказаного року, місяця та дня, введеного в аргументах функції та відображає у стовпці "NewDate". Результат: "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.

Вибір функції "правильна дата"

Потрібна додаткова довідка?

Отримуйте нові функції раніше за інших
Приєднатися до оцінювачів Microsoft Office

Чи були ці відомості корисні?

Наскільки ви задоволені якістю перекладу?
Що вплинуло на ваші враження?

Дякуємо за ваш відгук!

×