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 MyTimeMyTime = TimeSerial(16, 35, 17)    ' MyTime contains serial representation of 4:35:17 PM.

Elegir la función de fecha correcta

¿Necesita más ayuda?

¿Quiere más opciones?

Explore las ventajas de las suscripciones, examine los cursos de aprendizaje, aprenda a proteger su dispositivo y mucho más.

Las comunidades le ayudan a formular y responder preguntas, enviar comentarios y leer a expertos con conocimientos extensos.