Função TimeSerial do VBScript

Definição e uso

A função TimeSerial pode combinar hora, minuto e segundo em um momento.

Observação:Se a hora, minuto ou segundo exceder o intervalo esperado, o cálculo é o mesmo que o de DateSerial. Se o tempo calculado for menor que #00:00:00#, o tempo negativo será automaticamente convertido para positivo; se o tempo calculado for maior ou igual a #24:00:00#, o tempo será aumentado para tornar os dados um conjunto de dados de data e hora, com a data de início sendo #12/30/1899#.

Sintaxe

TimeSerial(hour,minute,second)
Parâmetro Descrição
hour Obrigatório. Número entre 0-23 ou expressão numérica.
minute Obrigatório. Número entre 0-59 ou expressão numérica.
second Obrigatório. Número entre 0-59 ou expressão numérica.

Para especificar um momento, como 11:59:59, os valores dos parâmetros de TimeSerial devem estar dentro do intervalo aceitável; isso é, a hora deve estar entre 0-23 e os minutos e segundos entre 0-59. No entanto, pode-se usar uma expressão numérica para especificar um tempo relativo para cada parâmetro, essa expressão representa o número de horas, minutos ou segundos antes ou depois de um momento específico.

Quando qualquer um dos parâmetros exceder o intervalo aceitável, ele se ajusta corretamente para o próximo maior intervalo de tempo. Por exemplo, se for especificado 75 minutos, o tempo é interpretado como 1 hora e 15 minutos. No entanto, se qualquer um dos valores dos parâmetros estiver fora do intervalo de -32768 a 32767, isso causará um erro. Além disso, se a data especificada diretamente por três parâmetros ou calculada por expressão estiver fora do intervalo aceitável, também causará um erro.

Exemplo

Exemplo 1

document.write(TimeSerial(9,30,50)) 'Método de chamada normal'

Saída:

9:30:50 ou 9:30:50 AM

Exemplo 2

document.write(TimeSerial(0,9,11)) 'Método de chamada normal'

Saída:

0:09:11 ou 12:09:11 AM

Exemplo 3

document.write(TimeSerial(14+2,9-2,1-1)) 'Saída com base no resultado da expressão numérica'

Saída:

16:07:00 ou 4:07:00 PM

Exemplo 4

document.write(TimeSerial(26,30,0)) 'A data começa a contar a partir de #12/30/1899# e aumenta 1 dia'

Saída:

31-12-1899 2:30:00 AM