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