Функция TimeValue (Visual Basic)
Обновлен: Ноябрь 2007
Возвращает значение типа Date, содержащее строковое представление времени с датой установленной на 1 января 1 года.
Public Function TimeValue(ByVal StringTime As String) As DateTime
Параметры
- StringTime
Обязательный компонент. Выражение String, представляющее значение даты и времени в диапазоне от 00:00:00 1 января 1 года до 23:59:59 31 декабря 9999 года.
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
StringTime содержит недопустимое значение даты. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic версии 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако по возможности следует заменить такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Можно вводить допустимые значения времени, используя 12-часовой или 24-часовой формат. Например, "2:24 P.M." и "14:24" являются допустимыми аргументами StringTime.
Если аргумент StringTime содержит информацию о дате, функция TimeValue не включает ее в возвращаемое значение. Однако, если StringTime содержит сведения о неверной дате, такой как "32 января", возникает ошибка InvalidCastException.
Пример
В следующем примере функция TimeValue используется для преобразования строки в значение времени. Чтобы присвоить время переменной типа Date, можно также использовать литералы даты.
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
Требования
Пространство имен:Microsoft.VisualBasic
Модуль: DateAndTime
Сборка: Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)
См. также
Ссылки
Функция DateSerial (Visual Basic)
Функция DateValue (Visual Basic)
Функция TimeSerial (Visual Basic)