TimeSerial (Función)

Visual Basic VBLR

TimeSerial (Función)

       

Devuelve un tipo Variant (Date) que contiene la hora actual para una hora, minuto y segundo específicos.

Sintaxis

TimeSerial(hora, minuto, segundo)

La sintaxis de la función TimeSerial consta de los siguientes argumentos con nombre:

Parte Descripción
hora Requerido; Variant (Integer). Número entre 0 (12:00 a.m.) y 23 (11:00 p.m.), inclusive o una 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 intervalo de números para cada argumento de TimeSerial debería estar en el intervalo normalmente aceptado para la unidad; es decir, 0–23 para horas y 0–59 para minutos y segundos. Sin embargo, puede especificar horas relativas para cada argumento, usando cualquier expresión numérica que represente algunas horas, minutos o segundos antes o después de cierta hora. El ejemplo siguiente usa expresiones en lugar de números de hora absoluta. La función TimeSerial devuelve una hora que es 15 (-15) minutos menos que seis horas antes del mediodía (12 - 6), ó 5:45:00 a.m.

TimeSerial(12 - 6, -15, 0)

Cuando algún argumento supera el intervalo normalmente aceptado para él, se incrementa hasta la siguiente unidad mayor. Por ejemplo, si especifica 75 minutos, se evalúa como una hora y 15 minutos. No obstante, si un solo argumento está fuera del intervalo -32.768 a 32.767 o si la hora especificada por los tres argumentos, directamente o mediante expresión, hace que la fecha quede fuera del intervalo aceptable de valores, se produce un error.