Função SerieHora

Devolve uma Variante (Data) que contém a hora de uma hora, minuto ou segundo específicos.

Sintaxe

TimeSerial (hora, minuto, segundo) ) (

Aviso    Certifique-se de que os argumentos estão na gama correta de valores. Um argumento inválido pode resultar num resultado incorreto.

A sintaxe da função TimeSerial tem estes argumentos:

Argumento

Descrição

hora

Obrigatório. Variante (Inteiro). Número entre 0 (12:00) e 23 (23:00), inclusive, ou um expressão numérica.

minuto

Obrigatório. Variante (Inteiro). Qualquer expressão numérica.

segundo

Obrigatório. Variante (Inteiro). Qualquer expressão numérica.

Observações

Para especificar uma hora, como 11:59:59, o intervalo de números para cada argumento TimeSerial deve estar no intervalo normal para a unidade; ou seja, 0-23 por horas e 0-59 por minutos e segundos. No entanto, também pode especificar tempos relativos para cada argumento usando qualquer expressão numérica que represente um número de horas, minutos ou segundos antes ou depois de um determinado tempo. O exemplo que se segue usa expressões em vez de números de tempo absolutos. A função TimeSerial devolve uma hora durante 15 minutos antes (-15) seis horas antes do meio-dia (12 - 6) ou 5:45:00 da manhã.

TimeSerial(12 - 6, -15, 0)

Quando qualquer argumento excede a gama normal para esse argumento, ele aumenta para a próxima unidade maior, conforme apropriado. Por exemplo, se especificar 75 minutos, é avaliado como uma hora e 15 minutos. Se algum argumento estiver fora do alcance -32.768 a 32.767, ocorre um erro. Se o tempo especificado pelos três argumentos fizer com que a data fique fora do intervalo aceitável de datas, ocorre um erro.

Exemplo de consulta

Expressão

Resultados

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

Devolve o "Tempo" composto por hora, minuto e segundo especificados inscritos nos argumentos da função e apresenta na coluna NewTime. Resultado: "18:12:10".

Exemplo vBA

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função TimeSerial para devolver um tempo para a hora, minuto e segundo especificados.

Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.

Nota:  Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode indicar-nos se estas informações foram úteis? Eis o artigo em inglês para sua referência.​

Consulte Também

Escolha a função de data certa

Mantenha um passo à frente com o Microsoft 365

Precisa de mais ajuda?

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×