Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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 no intervalo de valores correto. 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 (Número Inteiro). Número entre 0 (0:00) e 23 (23:00), inclusive ou um expressão numérica.

minuto

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

segundo

Obrigatório. Variante (Número 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 da unidade; ou seja, 0 a 23 para horas e 0-59 para minutos e segundos. No entanto, também pode especificar horas relativas para cada argumento utilizando qualquer expressão numérica que represente algum número de horas, minutos ou segundos antes ou depois de uma determinada hora. O exemplo seguinte utiliza expressões em vez de números de tempo absolutos. A função TimeSerial devolve uma hora de 15 minutos antes (-15) seis horas antes do meio-dia (12 - 6) ou 5:45:00

TimeSerial(12 - 6, -15, 0)

Quando um argumento excede o intervalo normal desse argumento, incrementa para a unidade maior seguinte, conforme adequado. Por exemplo, se especificar 75 minutos, este é avaliado como uma hora e 15 minutos. Se um único argumento estiver fora do intervalo -32.768 a 32.767, ocorrerá um erro. Se a hora especificada pelos três argumentos fizer com que a data caia fora do intervalo aceitável de datas, ocorre um erro.

Exemplo de consulta

Expressão

Resultados

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

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

Exemplo de 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 uma hora para a hora, minuto e segundo especificados.

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

Escolher a função de data correta

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.