Devuelve un tipo de datos Variant (Date) que contiene la hora para una hora, minuto y segundo concretos.
Sintaxis
TimeSerial(hora, minuto, segundo)
Advertencia Asegúrese de que los argumentos están en el rango de valores correcto. Un argumento no válido puede dar lugar a un resultado incorrecto.
La sintaxis de la función TimeSerial consta de los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| hora | Obligatorio. Variante (entero). Número entre 0 (12:00 h) y 23 (11:00 h), ambos inclusive o una expresión numérica. |
| minuto | Obligatorio. Variante (entero). Cualquier expresión numérica. |
| segundo | Obligatorio. Variante (entero). Cualquier expresión numérica. |
Observaciones
Para especificar una hora, como 11:59:59, el rango de números para cada argumento TimeSerial debe estar en el rango normal de la unidad; es decir, de 0 a 23 durante horas y de 0 a 59 durante minutos y segundos. Sin embargo, también puede especificar horas relativas para cada argumento mediante cualquier expresión numérica que represente un número determinado de horas, minutos o segundos anteriores o posteriores a una hora determinada. En el ejemplo siguiente se usan expresiones en lugar de números de hora absolutos. La función TimeSerial devuelve una hora de 15 minutos antes de (-15), seis horas antes del mediodía (12 - 6) o 5:45:00 a.m.
TimeSerial(12 - 6, -15, 0)
Cuando cualquier argumento excede el rango normal para ese argumento, se incrementa a la siguiente unidad más grande según corresponda. Por ejemplo, si especifica 75 minutos, se evalúa como una hora y 15 minutos. Si cualquier argumento único está fuera del intervalo de -32.768 a 32.767, se produce un error. Si el tiempo especificado por los tres argumentos hace que la fecha se encuentre fuera del intervalo aceptable de fechas, se produce un error.
Ejemplo de consulta
| Expresión | Resultados |
|---|---|
| SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); | Devuelve la "Hora" compuesta por la hora, el minuto y el segundo especificados especificados en los argumentos de la función y se muestra en la columna NewTime. Resultado: "6:12:10 PM". |
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 TimeSerial para devolver una hora para la hora, el minuto y el segundo especificados.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.