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 como resultado incorrecto.
La sintaxis de la función SerieHora tiene estos argumentos:
Argumento |
Descripción |
hora |
Requerido. Variant (Integer). Número entre 0 (12:00 a.m.) y 23 (11:00 p.m.), ambos inclusive, o un expresión numérica. |
minuto |
Requerido. Variant (Integer). Cualquier expresión numérica. |
segundo |
Requerido. Variant (Integer). Cualquier expresión numérica. |
Comentarios
Para especificar una hora, como 11:59:59, el rango de números para cada argumento SerieHora debe estar en el rango normal de la unidad; es decir, de 0 a 23 para horas y de 0 a 59 para minutos y segundos. Sin embargo, también puede especificar horas relativas para cada argumento con cualquier expresión numérica que represente algún número de horas, minutos o segundos antes o después de una determinada hora. En el ejemplo siguiente se usan expresiones en lugar de números de hora absolutos. La función SerieHora devuelve una hora de 15 minutos antes (-15) seis horas antes del mediodía (12 - 6) o 5:45:00 a.m.
TimeSerial(12 - 6, -15, 0)
Cuando un argumento supera el rango normal de ese argumento, se incrementa a la siguiente unidad mayor según corresponda. Por ejemplo, si especifica 75 minutos, se evaluará como una hora y 15 minutos. Si alguno de los argumentos está fuera del intervalo de -32.768 a 32.767, se produce un error. Si la hora especificada por los tres argumentos hace que la fecha quede fuera del intervalo aceptable de fechas, se produce un error.
Ejemplo de consulta
Expression |
Resultados |
SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); |
Devuelve la "Hora" compuesta por una hora, minuto y segundo especificados en los argumentos de la función y se muestra en la columna NewTime. Resultado: "6:12:10 p.m.". |
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, minuto y segundo especificados.
Dim MyTime
MyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.