Home Library Learn Downloads Support Community
Sign in | United States - English | |
1 out of 1 rated this helpful - Rate this topic

TimeValue Function (Visual Basic)

Visual Studio 2008

Returns a Date value containing the time information represented by a string, with the date information set to January 1 of the year 1.

Copy 
Public Function TimeValue(ByVal StringTime As String) As DateTime
StringTime

Required. String expression representing a date/time value from 00:00:00 on January 1 of the year 1 through 23:59:59 on December 31, 9999.

Exception type

Error number

Condition

InvalidCastException

13

StringTime includes invalid date information.

See the "Error number" column if you are upgrading Visual Basic 6.0 applications that use unstructured error handling. (You can compare the error number against the Number Property (Err Object).) However, when possible, you should consider replacing such error control with Structured Exception Handling Overview for Visual Basic.

You can enter valid times using a 12-hour or 24-hour clock. For example, "2:24 P.M." and "14:24" are both valid StringTime arguments.

If the StringTime argument includes date information, TimeValue does not include it in the returned value. However, if StringTime includes invalid date information, for example "January 32," an InvalidCastException error occurs.

The following example uses the TimeValue function to convert a string to a time. You can also use date literals to directly assign a time to a Date variable.

VB
Copy 
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")

Namespace: Microsoft.VisualBasic

Module: DateAndTime

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ