Функция TimeValue

Применяется к
Access для Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Возвращает значение типа Variant (Date), содержащее время.

Синтаксис

TimeValue(time)

Требуемый аргумент времениобычно представляет собой строковое выражение, представляющее время с 0:00:00 (12:00:00) до 23:59:59 (23:59:59 вечера) включительно. Однако время также может быть любым выражением, которое представляет время в этом диапазоне. Если время содержит значение NULL, возвращается значение NULL .

Замечания

Допустимое время можно ввести с помощью 12-часовых или 24-часовых часов. Например, "2:24PM" и "14:24" являются допустимыми аргументами времени .

Если аргумент time содержит сведения о дате, значение TimeValue не возвращает его. Однако если время содержит недопустимые сведения о дате, возникает ошибка.

Примеры запросов

Выражение Результаты
SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; Возвращает значения времени поля DateTime без сведений о дате и отображается в столбце Expr1.
SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; Возвращает значения времени поля DateTime без сведений о дате и отображается в столбце JustTime.

Пример VBA

Примечание

В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.

В этом примере функция TimeValue используется для преобразования строки в время. Вы также можете использовать литералы даты для непосредственного назначения времени переменной Variant или Date , например MyTime = #4:35:17 PM#.

Dim MyTime
MyTime = TimeValue("4:35:17 PM")    ' Return a time.

Выбор правильной функции даты