TimeValue (Función, Visual Basic)
Actualización: noviembre 2007
Devuelve un valor Date que contiene información sobre la hora representada por una cadena, con la información sobre la fecha establecida en el 1 de enero del año 1.
Public Function TimeValue(ByVal StringTime As String) As DateTime
Parámetros
- StringTime
Requerido. Expresión de tipo String que representa un valor de fecha u hora desde las 00:00:00 del 1 de enero del año 1 hasta las 23:59:59 del 31 de diciembre de 9999.
Excepciones
Tipo de excepción |
Número de error |
Condición |
---|---|---|
StringTime incluye información de fecha no válida. |
Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.
Comentarios
Se pueden introducir horas válidas utilizando un reloj de 12 horas o de 24 horas. Por ejemplo, "2:24 P.M." y "14:24" son argumentos StringTime válidos.
Si el argumento StringTime incluye información de fecha, TimeValue no la incluye en el valor devuelto. Sin embargo, si StringTime incluye información de fecha no válida, por ejemplo el "32 de enero", se produce un error de InvalidCastException.
Ejemplo
El ejemplo siguiente utiliza la función TimeValue para convertir una cadena en una hora. También se pueden utilizar literales de fecha para asignar directamente una hora a una variable Date.
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
Requisitos
Espacio de nombres:Microsoft.VisualBasic
**Módulo:**DateAndTime
Ensamblado: Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)
Vea también
Referencia
DateSerial (Función, Visual Basic)
DateValue (Función, Visual Basic)
Second (Función, Visual Basic)
TimeSerial (Función, Visual Basic)