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 un resultado incorrecto.

La sintaxis de la función TimeSerial tiene estos argumentos:

argumento

Descripción

hora

Obligatorio. Variant (Integer). Número entre 0 (12:00 a.m.) y 23 (11:00 p.m.), ambos inclusive, o una expresión numérica.

minuto

Obligatorio. Variant (Integer). Cualquier expresión numérica.

segundo

Obligatorio. Variant (Integer). 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 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 un número determinado de horas, minutos o segundos antes o después de un tiempo determinado. En el ejemplo siguiente se usan expresiones en lugar de números de tiempo absolutos. La función TimeSerial devuelve una hora durante 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 de mayor tamaño según corresponda. Por ejemplo, si especifica 75 minutos, se evalúa como una hora y 15 minutos. Si un único argumento está fuera del rango -32.768 a 32.767, se produce un error. Si la hora especificada por los tres argumentos hace que la fecha no se encuentra fuera del intervalo aceptable de fechas, se produce un error.

Ejemplo de consulta

Expresión

Resultados

SELECCIONE TimeSerial(18,12,10) COMO NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10);

Devuelve la "Hora" que está hecha de horas, minutos y segundos especificados en los argumentos de la función y se muestra en la columna NewTime. Resultado: "6:12:10 p.m".

Ejemplo de VBA

Nota: Los ejemplos siguientes muestran el uso de esta función en un módulo 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 junto a Buscar y escriba uno o más 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.

Elegir la función de fecha adecuada

¿Necesita más ayuda?

Ampliar sus conocimientos
Explorar los cursos
Obtener nuevas características primero
Unirse a Microsoft Office Usuarios de Insider

¿Le ha sido útil esta información?

¿Cuál es tu grado de satisfacción con la calidad del lenguaje?
¿Qué ha afectado a tu experiencia?

¡Gracias por sus comentarios!

×