Devuelve un tipo de datos Variant (Date) que contiene la hora.
Sintaxis
TimeValue(time)
El argumento de tiemporequerido suele ser una expresión de cadena que representa una hora entre 0:00:00 (12:00:00 a.m.) y 23:59:59 (11:59:59 p.m.), inclusive. Sin embargo, el tiempo también puede ser cualquier expresión que represente un tiempo en ese intervalo. Si la hora contiene Null, se devuelve Null .
Observaciones
Puede introducir horas válidas utilizando un reloj de 12 o 24 horas. Por ejemplo, "2:24PM" y "14:24" ambos son argumentos de tiempo válidos.
Si el argumento de hora contiene información de fecha, TimeValue no la devuelve. Sin embargo, si la hora incluye información de fecha no válida, se produce un error.
Ejemplos de consulta
| Expresión | Resultados |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; | Devuelve los valores de hora del campo "DateTime" sin la información de fecha y se muestra en la columna Expr1. |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; | Devuelve los valores de hora del campo "DateTime" sin la información de fecha y se muestra en la columna JustTime. |
Ejemplo VBA:
Nota
Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione referencia para desarrolladores en la lista desplegable situada junto a búsqueda y escriba uno o varios términos en el cuadro de búsqueda.
En este ejemplo se usa la función HoraValor para convertir una cadena en una hora. También puede usar literales de fecha para asignar directamente una hora a una variableVariant o Date, por ejemplo, MyTime = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.