Повертає значення типу Variant (Date), яке містить час певної години, хвилини та секунди.
Синтаксис
TimeSerial (години, хвилини, секунди)
Попередження Переконайтеся, що аргументи розташовано в правильному діапазоні значень. Неприпустимий аргумент може призвести до неправильного результату.
Синтаксис функції TimeSerial має такі аргументи:
| Аргумент | Опис |
|---|---|
| годину | — обов’язковий аргумент. Variant (ціле число). Число від 0 (00:00) до 23 (23:00) включно або числовий вираз. |
| хвилини | — обов’язковий аргумент. Variant (ціле число). Будь-який числовий вираз. |
| другий | — обов’язковий аргумент. Variant (ціле число). Будь-який числовий вираз. |
Примітки
Щоб задати час, наприклад 11:59:59, діапазон чисел для кожного аргументу TimeSerial має бути у діапазоні норми для одиниці виміру; Тобто 0–23 для годин і 0–59 для хвилин і секунд. Однак ви також можете вказати відносний час для кожного аргументу, використовуючи будь-який числовий вираз, який являє собою певну кількість годин, хвилин або секунд до або після певного проміжку часу. У наступному прикладі замість абсолютних чисел часу використовуються вирази. Функція TimeSerial повертає значення часу за 15 хвилин до (-15) за шість годин до полудня (12 - 6) або 5:45:00 ранку.
TimeSerial(12 - 6, -15, 0)
Якщо будь-який аргумент виходить за рамки нормального діапазону для цього аргументу, він переходить до наступного вищого елемента відповідно. Наприклад, якщо вказати 75 хвилин, то він оцінюватиметься як одна година 15 хвилин. Якщо будь-який один аргумент виходить за межі діапазону від –32 768 до 32 767, станеться помилка. Якщо час, указаний трьома аргументами, призводить до того, що дата виходить за межі прийнятного діапазону дат, станеться помилка.
Приклад запиту
| Вираз | Результати. |
|---|---|
| SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); | Повертає значення часу, складене з указаних годин, хвилин і секунд, введених в аргументах функції, і відображає у стовпці NewTime. Результат: "18:12:10". |
Приклад VBA
Примітка.
У прикладах нижче показано використання цієї функції в модулі Visual Basic for Applications (VBA). Щоб отримати докладні відомості про використання модуля VBA, клацніть пункт Довідник розробника в розкривному списку поряд із полем Пошук і введіть у поле пошуку принаймні один термін.
У цьому прикладі функція TimeSerial використовується, щоб повернути значення часу для вказаних годин, хвилин і секунд.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.