TimeSerial

Devuelve un objeto Variant del subtipo Date que contiene la hora, el minuto y el segundo correspondientes a un momento concreto.

Estructura

TimeSerial(hora, minuto, segundo)

Parámetros

hora - Número entre 0 (12:00 a. m.) y el 23 (23:00 h), ambos inclusive, o una expresión numérica.

minuto - Cualquier expresión numérica.

segundo: cualquier expresión numérica.

Descripción

Para especificar una hora, como por ejemplo 11:59:59, el intervalo de números de cada argumento TimeSerial debe estar dentro del rango válido para la unidad; es decir, de 0 a 23 para las horas y de 0 a 59 para los minutos y los segundos. No obstante, también puedes especificar horas relativas para cada argumento utilizando cualquier expresión numérica que represente un número de horas, minutos o segundos antes o después de una hora determinada.

Ejemplo

En el siguiente ejemplo se utilizan expresiones en lugar de valores numéricos de tiempo absolutos. La función TimeSerial devuelve una hora que corresponde a 15 minutos antes (-15) de las 12 del mediodía (12 - 6), es decir, las 5:45:00 a. m.

Dim MyTime1

MyTime1 = TimeSerial(12 - 6, -15, 0) ' Devuelve las 5:45:00 a. m.

Cuando un argumento supera el rango aceptado para ese argumento, se redondea al alza a la unidad superior correspondiente. Por ejemplo, si se indican 75 minutos, se interpreta como una hora y 15 minutos. Sin embargo, si alguno de los argumentos se encuentra fuera del intervalo comprendido entre -32 768 y 32 767, o si la hora especificada por las tres estructuras, ya sea directamente o mediante una expresión, hace que la fecha quede fuera del intervalo de fechas admisible, se produce un error. |