Функція DateSerial

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

Синтаксис

DateSerial ( year, month, day )

Синтаксис функції DateSerial має такі аргументи:

Аргумент

Опис

year

Обов’язковий аргумент типу Integer. Число від 100 до 9999 включно або числовий вираз.

month

Обов’язковий аргумент типу 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)

Двозначні роки в аргументі year інтерпретуються на основі параметрів комп’ютера, визначених користувачем. За стандартних параметрів значення 0–29 включно інтерпретуються як 2000–2029 рр., а 30–99 – як 1930–1999 рр. Для всіх інших аргументів year, використовуйте чотиризначний рік (наприклад, 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).

Приклад

Примітка : У прикладах нижче показано використання цієї функції в модулі 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.

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

Ця інформація корисна?

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

Дякуємо за відгук! Схоже, вам може стати в нагоді допомога одного з наших спеціалістів служби підтримки Office, з яким ми вас можемо з’єднати.

×